Ograniczenia schematu

Dotyczy: .NET Framework .NET Standard

Drugi opcjonalny parametr metody GetSchema to ograniczenia, które są używane do ograniczania ilości zwracanych informacji schematu i jest przekazywany do metody GetSchema jako tablicy ciągów. Pozycja w tablicy określa wartości, które można przekazać, i jest to równoważne liczbie ograniczeń.

Na przykład w poniższej tabeli opisano ograniczenia obsługiwane przez kolekcję schematów "Tabele" przy użyciu dostawcy danych Microsoft SqlClient dla programu SQL Server. Dodatkowe ograniczenia dotyczące kolekcji schematów programu SQL Server są wymienione na końcu tego tematu.

Nazwa ograniczenia	Nazwa parametru	Domyślne ograniczenie	Liczba ograniczeń
Catalog	@Catalog	KATALOG_TABEL	1
Właściciel	@Owner	TABLE_SCHEMA	2
Tabela	@Name	NAZWA_TABELI	3
RodzajTabeli	@TableType	RODZAJ_TABELI	4

Określanie wartości ograniczeń

Aby użyć jednego z ograniczeń kolekcji schematów "Tabele", po prostu utwórz tablicę ciągów z czterema elementami, a następnie umieść wartość w elemecie zgodnym z liczbą ograniczeń. Aby na przykład ograniczyć tabele zwracane przez metodę GetSchema tylko do tych tabel w schemacie "Sales", ustaw drugi element tablicy na "Sales" przed przekazaniem jej do metody GetSchema .

Uwaga / Notatka

Kolekcje ograniczeń dla SqlClient mają dodatkową kolumnę ParameterName. Domyślna kolumna ograniczeń jest nadal dostępna dla zgodności z poprzednimi wersjami, ale jest obecnie ignorowana. Zapytania sparametryzowane zamiast zastępowania ciągów powinny być używane w celu zminimalizowania ryzyka ataku iniekcyjnego SQL podczas określania wartości ograniczeń.
Liczba elementów w tablicy musi być mniejsza lub równa liczbie ograniczeń obsługiwanych dla określonej kolekcji schematów. W przeciwnym razie ArgumentException zostanie zgłoszony element . Może istnieć mniej niż maksymalna liczba ograniczeń. Przyjmuje się, że brakujące ograniczenia mają wartość null (bez ograniczeń).

Aby określić listę obsługiwanych ograniczeń, możesz wysłać zapytanie do dostawcy danych Microsoft SqlClient dla programu SQL Server, wywołując metodę GetSchema o nazwie kolekcji schematów ograniczeń, czyli "Ograniczenia". Spowoduje to zwrócenie DataTable wartości z listą nazw kolekcji, nazw ograniczeń, domyślnych wartości ograniczeń i numerów ograniczeń.

Example

W poniższych przykładach pokazano, jak używać metody GetSchema dostawcy danych Microsoft SqlClient dla SQL Server SqlConnection w celu pobrania informacji o schemacie wszystkich tabel zawartych w przykładowej bazie danych AdventureWorks oraz ograniczenia informacji zwracanych tylko do tych tabel w schemacie "Sales".

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main(string[] args)
    {
        string connectionString = "Data Source = localhost; Integrated Security = true; Initial Catalog = AdventureWorks";
        
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();

            // Specify the restrictions.  
            string[] restrictions = new string[4];
            restrictions[1] = "Sales";
            System.Data.DataTable table = connection.GetSchema("Tables", restrictions);

            // Display the contents of the table.  
            DisplayData(table);
            Console.WriteLine("Press any key to continue.");
            Console.ReadKey();
        }
    }

    private static void DisplayData(System.Data.DataTable table)
    {
        foreach (System.Data.DataRow row in table.Rows)
        {
            foreach (System.Data.DataColumn col in table.Columns)
            {
                Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);
            }
            Console.WriteLine("============================");
        }
    }
}