スキーマの制限

適用対象： .NET Framework .NET .NET Standard

ADO.NET のダウンロード

GetSchema メソッドの 2 番目のオプション パラメーターは、返されるスキーマ情報の量を制限するために使用される制限で、文字列の配列として GetSchema メソッドに渡されます。 配列での位置により、渡すことができる値が決定します。これは、制限の番号に相当します。

たとえば、次の表は、Microsoft SqlClient Data Provider for SQL Server を使用する "テーブル" スキーマ コレクションでサポートされている制限を示しています。 SQL Server スキーマ コレクションの追加の制限をこのトピックの終わりに示します。

制限値の指定

"Tables" スキーマ コレクションの制限の 1 つを使用するには、4 つの要素を使って文字列の配列を作成してから、制限の番号と一致する要素内に値を配置します。 たとえば、GetSchema メソッドにより返されるテーブルを、"Sales" スキーマ内のテーブルのみに制限するには、GetSchema メソッドに渡す前に、配列の 2 番目の要素を "Sales" に設定します。

Microsoft SqlClient Data Provider for SQL Server に対してクエリを実行して、サポートされている制限の一覧を確認するには、"Restrictions" という制限のスキーマ コレクションの名前を指定して GetSchema メソッドを呼び出します。 これにより、コレクション名の一覧、制限の名前、既定の制限値、および制限の番号と共に、DataTable が返されます。

例

Microsoft SqlClient Data Provider for SQL Server SqlConnection クラスの GetSchema メソッドを使って、AdventureWorks サンプル データベースに含まれるすべてのテーブルに関するスキーマ情報を取得し、返される情報を "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("============================");
        }
    }
}

SQL Server スキーマの制限

次の表に、SQL Server スキーマ コレクションの制限を示します。

Users

データベース

[テーブル]

列

StructuredTypeMembers

Views

ViewColumns

ProcedureParameters

プロシージャ

IndexColumns

Indexes

UserDefinedTypes

ForeignKeys

関連項目

• Microsoft ADO.NET for SQL Server