DbDataAdapter.FillSchemaとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

DbDataAdapter.FillSchema メソッド (DataTable, SchemaType, IDbCommand, CommandBehavior)

指定した SchemaType、コマンド文字列、および CommandBehavior 値に基づいて、指定した DataTable のスキーマを設定します。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Protected Overridable Function
 FillSchema ( _
    dataTable As DataTable, _
    schemaType As SchemaType, _
    command As IDbCommand, _
    behavior As CommandBehavior _
) As DataTable
Visual Basic (使用法)
Dim dataTable As DataTable
Dim schemaType As SchemaType
Dim command As IDbCommand
Dim behavior As CommandBehavior
Dim returnValue As DataTable

returnValue = Me.FillSchema(dataTable, schemaType, command, behavior)
C#
protected virtual DataTable FillSchema (
    DataTable dataTable,
    SchemaType schemaType,
    IDbCommand command,
    CommandBehavior behavior
)
C++
protected:
virtual DataTable^ FillSchema (
    DataTable^ dataTable, 
    SchemaType schemaType, 
    IDbCommand^ command, 
    CommandBehavior behavior
)
J#
protected DataTable FillSchema (
    DataTable dataTable, 
    SchemaType schemaType, 
    IDbCommand command, 
    CommandBehavior behavior
)
JScript
protected function FillSchema (
    dataTable : DataTable, 
    schemaType : SchemaType, 
    command : IDbCommand, 
    behavior : CommandBehavior
) : DataTable

パラメータ

dataTable

データ ソースから返されたスキーマを格納するための DataTable。

schemaType

SchemaType 値の 1 つ。

command

データ ソースから行を取得するために使用する SQL SELECT ステートメント。

behavior

CommandBehavior 値の 1 つ。

戻り値
データ ソースから返されたスキーマ情報が格納された DataTable オブジェクト。

解説解説

FillSchema メソッドは、SelectCommand を使用して、データ ソースからスキーマを取得します。SelectCommand に関連付けられた接続オブジェクトは、有効なものでなければなりませんが、開いている必要はありません。FillSchema を呼び出す前に接続が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続が開いていた場合は、接続は開いたままになります。

FillSchema は、指定された DataSet に DataTable を追加します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。

また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。

主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。

DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、IDataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

FillSchema は行を返しません。DataTable に行を追加するには、Fill メソッドを使用します。

メモメモ

複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

FillSchema を使用する場合、.NET Framework SQL Server 用データ プロバイダは、実行するステートメントに FOR BROWSE 句を追加します。SET FMTONLY ON ステートメントの使用による干渉などの副作用に注意してください。詳細については、SQL Server Books Online を参照してください。

実装時の注意 FillSchema メソッドのこの実装はプロテクトされており、.NET Framework データ プロバイダでの使用を想定しています。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間
Fill

DbDataAdapter.FillSchema メソッド (DataSet, SchemaType, String)

指定した DataSet に DataTable を追加し、指定した SchemaType および DataTable に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function FillSchema ( _
    dataSet As DataSet, _
    schemaType As SchemaType, _
    srcTable As String _
) As DataTable()
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataSet As DataSet
Dim schemaType As SchemaType
Dim srcTable As String
Dim returnValue As DataTable()

returnValue = instance.FillSchema(dataSet, schemaType, srcTable)
C#
public DataTable[] FillSchema (
    DataSet dataSet,
    SchemaType schemaType,
    string srcTable
)
C++
public:
array<DataTable^>^ FillSchema (
    DataSet^ dataSet, 
    SchemaType schemaType, 
    String^ srcTable
)
J#
public DataTable[] FillSchema (
    DataSet dataSet, 
    SchemaType schemaType, 
    String srcTable
)
JScript
public function FillSchema (
    dataSet : DataSet, 
    schemaType : SchemaType, 
    srcTable : String
) : DataTable[]

パラメータ

dataSet

スキーマを挿入する DataSet。

schemaType

スキーマを挿入する方法を指定する SchemaType 値の 1 つ。

srcTable

テーブル マップに使用するソース テーブルの名前。

戻り値
DataSet に追加された DataTable オブジェクトのコレクションへの参照。

例外例外
例外の種類条件

ArgumentException

スキーマの取得元のソース テーブルが見つかりませんでした。

解説解説

このメソッドは、SelectCommand を使用して、データ ソースからスキーマ情報を取得します。

FillSchema は、指定された DataSet に DataTable を追加します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。

また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。

主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。

主キー情報は、Fill の実行時に、キー列が一致する行を検索および置換するために使用されます。この動作が不要な場合は、スキーマ情報を要求せずに Fill を使用してください。

DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、DbDataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

FillSchema メソッドは、大文字と小文字の違いを除いて名前が一致する DataTable オブジェクトが DataSet 内に複数含まれる場合に、それらを区別します。この場合、FillSchema は、大文字と小文字を区別して比較を実行し、対応するテーブルを見つけます。正確に一致するテーブルが存在しない場合は、新しく作成します。この動作を表す C# コードの例を次に示します。

 DataSet dataset = new DataSet();
 dataset.Tables.Add("aaa");
 dataset.Tables.Add("AAA");
 adapter.FillSchema(dataset, "aaa"); // Fills the schema of "aaa", which already
 exists in the DataSet.
 adapter.FillSchema(dataset, "Aaa"); // Adds a new table called "Aaa".

FillSchema を呼び出したときに、大文字と小文字の違いを除いて名前が一致する DataTable が DataSet 内に 1 つだけ含まれている場合は、その DataTable が更新されます。この場合は、比較のときに大文字と小文字が区別されません。この動作を表す C# コードの例を次に示します。

 DataSet dataset = new DataSet();
 dataset.Tables.Add("aaa");
 adapter.FillSchema(dataset, "AAA"); // Fills the schema of table "aaa" because only
 one similarly named table is in the DataSet.

SELECT コマンドに関連付けられた IDbConnection オブジェクトは、有効なものである必要がありますが、開いている必要はありません。FillSchema を呼び出す前に IDbConnection が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続を開いていた場合は、接続は開いたままになります。

メモメモ

複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

FillSchema を使用する場合、.NET Framework SQL Server 用データ プロバイダは、実行するステートメントに FOR BROWSE 句を追加します。SET FMTONLY ON ステートメントの使用による干渉などの副作用に注意してください。詳細については、SQL Server Books Online を参照してください。

使用例使用例

SqlDataAdapter 派生クラスを使用して、DataSet にスキーマを格納し、DataSet を返す例を次に示します。

Visual Basic
Private Function GetCustomerData(ByVal
 dataSetName As String, _
    ByVal connectionString As String)
 As DataSet

    Dim dataSet As DataSet = New
 DataSet(dataSetName)

    Using connection As SqlConnection = New
 SqlConnection(connectionString)

        Dim adapter As SqlDataAdapter = New
 SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add(
 _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName",
 "Name")
        mapping.ColumnMappings.Add("ContactName",
 "Contact")

        connection.Open()

        adapter.FillSchema(dataSet, SchemaType.Source, "Customers")
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function
C#
public static DataSet GetCustomerData(string
 dataSetName,
    string connectionString)
{
    DataSet dataSet = new DataSet(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(dataSet, SchemaType.Source, "Customers");
        adapter.Fill(dataSet);

        return dataSet;
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.FillSchema メソッド (DataTable, SchemaType)

指定した SchemaType に基いて、指定した DataTable のスキーマを設定します。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function FillSchema ( _
    dataTable As DataTable, _
    schemaType As SchemaType _
) As DataTable
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataTable As DataTable
Dim schemaType As SchemaType
Dim returnValue As DataTable

returnValue = instance.FillSchema(dataTable, schemaType)
C#
public DataTable FillSchema (
    DataTable dataTable,
    SchemaType schemaType
)
C++
public:
DataTable^ FillSchema (
    DataTable^ dataTable, 
    SchemaType schemaType
)
J#
public DataTable FillSchema (
    DataTable dataTable, 
    SchemaType schemaType
)
JScript
public function FillSchema (
    dataTable : DataTable, 
    schemaType : SchemaType
) : DataTable

パラメータ

dataTable

データ ソースから返されたスキーマを格納するための DataTable。

schemaType

SchemaType 値の 1 つ。

戻り値
データ ソースから返されたスキーマ情報が格納された DataTable。

解説解説

FillSchema メソッドは、SelectCommand を使用して、データ ソースからスキーマを取得します。SelectCommand に関連付けられた接続オブジェクトは、有効なものでなければなりませんが、開いている必要はありません。FillSchema を呼び出す前に接続が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続が開いていた場合は、接続は開いたままになります。

FillSchema は、DataTable を返します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。

また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。

主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。この処理では、サーバーに対する複数のラウンドトリップが必要になる場合があります。

DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、DbDataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

FillSchema は行を返しません。DataTable に行を追加するには、Fill メソッドを使用します。

メモメモ

複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

FillSchema を使用する場合、.NET Framework SQL Server 用データ プロバイダは、実行するステートメントに FOR BROWSE 句を追加します。SET FMTONLY ON ステートメントの使用による干渉などの副作用に注意してください。詳細については、SQL Server Books Online を参照してください。

使用例使用例

SqlDataAdapter 派生クラスを使用して、DataSet にスキーマを格納し、DataTable を返す例を次に示します。

Visual Basic
Private Function GetCustomerData(ByVal
 dataTableName As String, _
    ByVal connectionString As String)
 As DataTable

    Dim table As DataTable = New
 DataTable(dataTableName)

    Using connection As SqlConnection = New
 SqlConnection(connectionString)

        Dim adapter As SqlDataAdapter = New
 SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add(
 _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName",
 "Name")
        mapping.ColumnMappings.Add("ContactName",
 "Contact")

        connection.Open()

        adapter.FillSchema(table, SchemaType.Mapped)
        adapter.Fill(table)
        Return table
    End Using
End Function
C#
public static DataTable GetCustomerData(string
 dataSetName,
    string connectionString)
{
    DataTable table = new DataTable(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(table, SchemaType.Mapped);
        adapter.Fill(table);
        return table;
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間
Fill

DbDataAdapter.FillSchema メソッド (DataSet, SchemaType)

指定された DataSet に Table という名前の DataTable を追加し、指定された SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Overrides Function
 FillSchema ( _
    dataSet As DataSet, _
    schemaType As SchemaType _
) As DataTable()
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataSet As DataSet
Dim schemaType As SchemaType
Dim returnValue As DataTable()

returnValue = instance.FillSchema(dataSet, schemaType)
C#
public override DataTable[] FillSchema (
    DataSet dataSet,
    SchemaType schemaType
)
C++
public:
virtual array<DataTable^>^ FillSchema (
    DataSet^ dataSet, 
    SchemaType schemaType
) override
J#
public DataTable[] FillSchema (
    DataSet dataSet, 
    SchemaType schemaType
)
JScript
public override function FillSchema (
    dataSet : DataSet, 
    schemaType : SchemaType
) : DataTable[]

パラメータ

dataSet

スキーマを挿入する DataSet。

schemaType

スキーマを挿入する方法を指定する SchemaType 値の 1 つ。

戻り値
DataSet に追加された DataTable オブジェクトのコレクションへの参照。

解説解説

このメソッドは、SelectCommand を使用して、データ ソースからスキーマ情報を取得します。

FillSchema は、指定された DataSet に DataTable を追加します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。

また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。

主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。

主キー情報は、Fill の実行時に、キー列が一致する行を検索および置換するために使用されます。この動作が不要な場合は、スキーマ情報を要求せずに Fill を使用してください。

DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、IDataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

SELECT コマンドに関連付けられた IDbConnection オブジェクトは、有効なものである必要がありますが、開いている必要はありません。FillSchema を呼び出す前に IDbConnection が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続を開いていた場合は、接続は開いたままになります。

メモメモ

複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

FillSchema を使用する場合、.NET Framework SQL Server 用データ プロバイダは、実行するステートメントに FOR BROWSE 句を追加します。SET FMTONLY ON ステートメントの使用による干渉などの副作用に注意してください。詳細については、SQL Server Books Online を参照してください。

使用例使用例

SqlDataAdapter 派生クラスを使用して、DataSet にスキーマを格納し、DataSet を返す例を次に示します。

Visual Basic
Private Function GetCustomerData(ByVal
 dataSetName As String, _
    ByVal connectionString As String)
 As DataSet

    Dim dataSet As DataSet = New
 DataSet(dataSetName)

    Using connection As SqlConnection = New
 SqlConnection(connectionString)
        Dim adapter As SqlDataAdapter = New
 SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add(
 _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName",
 "Name")
        mapping.ColumnMappings.Add("ContactName",
 "Contact")

        connection.Open()

        adapter.FillSchema(dataSet, SchemaType.Mapped)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function
C#
public static DataSet GetCustomerData(string
 dataSetName,
    string connectionString)
{
    DataSet dataSet = new DataSet(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers",
 connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(dataSet, SchemaType.Mapped);
        adapter.Fill(dataSet);

        return dataSet;
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.FillSchema メソッド

DataTable を DataSet に追加し、データ ソース内のスキーマと一致するようにスキーマを設定します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
DbDataAdapter.FillSchema (DataSet, SchemaType) 指定された DataSet に Table という名前の DataTable を追加し、指定された SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.FillSchema (DataTable, SchemaType) 指定した SchemaType に基いて、指定した DataTable のスキーマを設定します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.FillSchema (DataSet, SchemaType, String) 指定した DataSet に DataTable を追加し、指定した SchemaType および DataTable に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.FillSchema (DataTable, SchemaType, IDataReader) DataTable を指定した DataSet に追加します。
DbDataAdapter.FillSchema (DataSet, SchemaType, String, IDataReader) DataTable を指定した DataSet に追加します。
DbDataAdapter.FillSchema (DataTable, SchemaType, IDbCommand, CommandBehavior) 指定した SchemaType、コマンド文字列、および CommandBehavior 値に基づいて、指定した DataTable のスキーマを設定します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.FillSchema (DataSet, SchemaType, IDbCommand, String, CommandBehavior) 指定した DataSet に DataTable を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.FillSchema メソッド (DataSet, SchemaType, IDbCommand, String, CommandBehavior)

指定した DataSet に DataTable を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Protected Overridable Function
 FillSchema ( _
    dataSet As DataSet, _
    schemaType As SchemaType, _
    command As IDbCommand, _
    srcTable As String, _
    behavior As CommandBehavior _
) As DataTable()
Visual Basic (使用法)
Dim dataSet As DataSet
Dim schemaType As SchemaType
Dim command As IDbCommand
Dim srcTable As String
Dim behavior As CommandBehavior
Dim returnValue As DataTable()

returnValue = Me.FillSchema(dataSet, schemaType, command, srcTable,
 behavior)
C#
protected virtual DataTable[] FillSchema (
    DataSet dataSet,
    SchemaType schemaType,
    IDbCommand command,
    string srcTable,
    CommandBehavior behavior
)
C++
protected:
virtual array<DataTable^>^ FillSchema (
    DataSet^ dataSet, 
    SchemaType schemaType, 
    IDbCommand^ command, 
    String^ srcTable, 
    CommandBehavior behavior
)
J#
protected DataTable[] FillSchema (
    DataSet dataSet, 
    SchemaType schemaType, 
    IDbCommand command, 
    String srcTable, 
    CommandBehavior behavior
)
JScript
protected function FillSchema (
    dataSet : DataSet, 
    schemaType : SchemaType, 
    command : IDbCommand, 
    srcTable : String, 
    behavior : CommandBehavior
) : DataTable[]

パラメータ

dataSet

データ ソースから返されたスキーマを格納するための DataSet。

schemaType

SchemaType 値の 1 つ。

command

データ ソースから行を取得するために使用する SQL SELECT ステートメント。

srcTable

テーブル マップに使用するソース テーブルの名前。

behavior

CommandBehavior 値の 1 つ。

戻り値
データ ソースから返されたスキーマ情報が格納された、DataTable オブジェクトの配列。

解説解説

FillSchema メソッドは、SelectCommand を使用して、データ ソースからスキーマを取得します。SelectCommand に関連付けられた接続オブジェクトは、有効なものでなければなりませんが、開いている必要はありません。FillSchema を呼び出す前に接続が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続が開いていた場合は、接続は開いたままになります。

FillSchema は、指定された DataSet に DataTable を追加します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。

また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。

主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。

DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、IDataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

FillSchema メソッドは、大文字と小文字の違いを除いて名前が一致する DataTable オブジェクトが DataSet 内に複数含まれる場合に、それらを区別します。この場合、FillSchema は、大文字と小文字を区別して比較を実行し、対応するテーブルを見つけます。正確に一致するテーブルが存在しない場合は、新しく作成します。この動作を表す C# コードの例を次に示します。

 DataSet dataset = new DataSet();
 dataset.Tables.Add("aaa");
 dataset.Tables.Add("AAA");
 adapter.FillSchema(dataset, "aaa"); // Fills the schema of "aaa", which already
 exists in the DataSet.
 adapter.FillSchema(dataset, "Aaa"); // Adds a new table called "Aaa".

FillSchema を呼び出したときに、大文字と小文字の違いを除いて名前が一致する DataTable が DataSet 内に 1 つだけ含まれている場合は、その DataTable が更新されます。この場合は、比較のときに大文字と小文字が区別されません。この動作を表す C# コードの例を次に示します。

 DataSet dataset = new DataSet();
 dataset.Tables.Add("aaa");
 adapter.FillSchema(dataset, "AAA"); // Fills the schema of table "aaa" because only
 one similarly named table is in the DataSet.

FillSchema は行を返しません。DataTable に行を追加するには、Fill メソッドを使用します。

メモメモ

複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

FillSchema を使用する場合、.NET Framework SQL Server 用データ プロバイダは、実行するステートメントに FOR BROWSE 句を追加します。SET FMTONLY ON ステートメントの使用による干渉などの副作用に注意してください。詳細については、SQL Server Books Online を参照してください。

実装時の注意 FillSchema メソッドのこの実装はプロテクトされており、.NET Framework データ プロバイダでの使用を想定しています。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間
Fill

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「DbDataAdapter.FillSchema」の関連用語

1
DbDataAdapter.FillSchema メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

DbDataAdapter.FillSchemaのお隣キーワード

DbDataAdapter.DefaultSourceTableName フィールド

DbDataAdapter.DeleteCommand プロパティ

DbDataAdapter.Dispose メソッド

DbDataAdapter.ExecuteBatch メソッド

DbDataAdapter.Fill メソッド

DbDataAdapter.FillCommandBehavior プロパティ

DbDataAdapter.FillSchema

DbDataAdapter.FillSchema メソッド

DbDataAdapter.GetBatchedParameter メソッド

DbDataAdapter.GetFillParameters メソッド

DbDataAdapter.InitializeBatching メソッド

DbDataAdapter.InsertCommand プロパティ

DbDataAdapter.OnRowUpdated メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


DbDataAdapter.FillSchemaのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS