Schemaeinschränkungen

Gilt für: .NET Framework .NET .NET Standard

Herunterladen von ADO.NET

Bei dem zweiten optionalen Parameter der GetSchema-Methode handelt es sich um Einschränkungen, die zum Einschränken der Menge der zurückgegebenen Schemainformationen verwendet werden. Dieser Parameter wird als Zeichenfolgenarray an die GetSchema-Methode übergeben. Die Position im Array bestimmt, welche Werte Sie übergeben können, und dies entspricht der Nummer der Einschränkung.

In der folgenden Tabelle werden beispielsweise die Einschränkungen beschrieben, die von der Schemasammlung „Tables“ mit dem Microsoft-SqlClient-Datenanbieter für SQL Server unterstützt werden. Zusätzliche Einschränkungen für SQL Server-Schemaauflistungen werden am Ende dieses Themas aufgeführt.

Festlegen von Einschränkungswerten

Wenn Sie eine der Einschränkungen der Tables-Schemaauflistung verwenden möchten, erstellen Sie ein Zeichenfolgenarray mit vier Elementen und fügen einen Wert in das Element ein, das mit der Einschränkungsnummer übereinstimmt. Um beispielsweise die von der GetSchema-Methode zurückgegebenen Tabellen auf die Tabellen im Schema „Sales“ zu beschränken, legen Sie vor der Übergabe an die GetSchema-Methode das zweite Element des Arrays auf „Sales“ fest.

Sie können den Microsoft-SqlClient-Datenanbieter für SQL Server abfragen, um die Liste der unterstützten Einschränkungen zu ermitteln, indem Sie die GetSchema-Methode mit dem Namen der Schemasammlung für Einschränkungen aufrufen. Diese Name lautet „Restrictions“. Dabei wird ein DataTable mit einer Liste der Sammlungsnamen, der Einschränkungsnamen, der Standardwerte für Einschränkungen und der Einschränkungsnummern zurückgegeben.

Beispiel

In den folgenden Beispielen wird veranschaulicht, wie die GetSchema-Methode der SqlConnection-Klasse des SqlClient-Datenanbieters für SQL Server verwendet wird, um Schemainformationen über alle in der Beispieldatenbank AdventureWorks enthaltenen Tabellen abzurufen und die zurückgegebenen Informationen auf die Tabellen im Schema „Sales“ einzuschränken:

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("============================");
        }
    }
}

SQL Server-Schemaeinschränkungen

In den folgenden Tabellen sind die Beschränkungen für SQL Server-Schemaauflistungen aufgeführt.

Benutzer

Datenbanken

Tabellen

Spalten

Mitglieder strukturierter Typen

Ansichten

Spalten anzeigen

ProcedureParameters

Prozeduren

IndexColumns

Indizes

Benutzerdefinierte Typen

ForeignKeys

Verwandte Inhalte

• Microsoft. Data.SqlClient für SQL Server