DataAdapter.FillSchema メソッド (DataSet, SchemaType)
アセンブリ: System.Data (system.data.dll 内)
構文Public Overridable Function FillSchema ( _ dataSet As DataSet, _ schemaType As SchemaType _ ) As DataTable()
Dim instance As DataAdapter Dim dataSet As DataSet Dim schemaType As SchemaType Dim returnValue As DataTable() returnValue = instance.FillSchema(dataSet, schemaType)
public virtual DataTable[] FillSchema ( DataSet dataSet, SchemaType schemaType )
public: virtual array<DataTable^>^ FillSchema ( DataSet^ dataSet, SchemaType schemaType )
public DataTable[] FillSchema ( DataSet dataSet, SchemaType schemaType )
public function FillSchema ( dataSet : DataSet, schemaType : SchemaType ) : DataTable[]
戻り値
データ ソースから返されたスキーマ情報が格納された DataTable。
解説FillSchema メソッドは、SelectCommand を使用して、データ ソースからスキーマを取得します。SelectCommand に関連付けられた接続オブジェクトは、有効なものでなければなりませんが、開いている必要はありません。FillSchema を呼び出す前に接続が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。FillSchema を呼び出す前に接続が開いていた場合は、接続は開いたままになります。
FillSchema は、指定された DataSet に DataTable を追加します。次に、DataTable の DataColumnCollection に列を追加します。データ ソースに次の DataColumn プロパティが存在する場合は、それを設定します。
また、FillSchema は、次の規則に従って、PrimaryKey プロパティと Constraints プロパティも設定します。
-
SelectCommand によって 1 つ以上の主キー列が返された場合は、それを DataTable の主キー列として使用します。
-
主キー列が返されず、一意の列が返された場合、それらの列すべてが null 値を許容しないときに限り、一意の列を主キーとして使用します。いずれかの列が null 許容であるときは、ConstraintCollection に UniqueConstraint を追加します。PrimaryKey プロパティは設定しません。
主キーおよび UNIQUE 制約は上記の規則に従って ConstraintCollection に追加されますが、その他の種類の制約は追加されないことに注意してください。
DataTable へのデータの格納中に重複する列が見つかった場合、2 番目以降の列には、DataAdapter によって、"columnname1"、"columnname2"、"columnname3" のような形式で名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。
FillSchema は行を返しません。DataTable に行を追加するには、Fill メソッドを使用します。
.gif) メモ |
|---|
| 複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データ プロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。 |
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataAdapter.FillSchema メソッド (DataTable, SchemaType, IDataReader)
アセンブリ: System.Data (system.data.dll 内)
構文Protected Overridable Function FillSchema ( _ dataTable As DataTable, _ schemaType As SchemaType, _ dataReader As IDataReader _ ) As DataTable
Dim dataTable As DataTable Dim schemaType As SchemaType Dim dataReader As IDataReader Dim returnValue As DataTable returnValue = Me.FillSchema(dataTable, schemaType, dataReader)
protected virtual DataTable FillSchema ( DataTable dataTable, SchemaType schemaType, IDataReader dataReader )
protected: virtual DataTable^ FillSchema ( DataTable^ dataTable, SchemaType schemaType, IDataReader^ dataReader )
protected DataTable FillSchema ( DataTable dataTable, SchemaType schemaType, IDataReader dataReader )
protected function FillSchema ( dataTable : DataTable, schemaType : SchemaType, dataReader : IDataReader ) : DataTable
戻り値
データ ソースから返されたスキーマ情報が格納された DataTable。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataAdapter.FillSchema メソッド (DataSet, SchemaType, String, IDataReader)
アセンブリ: System.Data (system.data.dll 内)
構文Protected Overridable Function FillSchema ( _ dataSet As DataSet, _ schemaType As SchemaType, _ srcTable As String, _ dataReader As IDataReader _ ) As DataTable()
Dim dataSet As DataSet Dim schemaType As SchemaType Dim srcTable As String Dim dataReader As IDataReader Dim returnValue As DataTable() returnValue = Me.FillSchema(dataSet, schemaType, srcTable, dataReader)
protected virtual DataTable[] FillSchema ( DataSet dataSet, SchemaType schemaType, string srcTable, IDataReader dataReader )
protected: virtual array<DataTable^>^ FillSchema ( DataSet^ dataSet, SchemaType schemaType, String^ srcTable, IDataReader^ dataReader )
protected DataTable[] FillSchema ( DataSet dataSet, SchemaType schemaType, String srcTable, IDataReader dataReader )
protected function FillSchema ( dataSet : DataSet, schemaType : SchemaType, srcTable : String, dataReader : IDataReader ) : DataTable[]
戻り値
DataSet に追加された DataTable オブジェクトのコレクションへの参照。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataAdapter.FillSchema メソッド
オーバーロードの一覧| 名前 | 説明 |
|---|---|
| DataAdapter.FillSchema (DataSet, SchemaType) | 指定した DataSet に DataTable を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。 .NET Compact Framework によってサポートされています。 |
| DataAdapter.FillSchema (DataTable, SchemaType, IDataReader) | DataTable を指定した DataSet に追加します。 .NET Compact Framework によってサポートされています。 |
| DataAdapter.FillSchema (DataSet, SchemaType, String, IDataReader) | DataTable を指定した DataSet に追加します。 .NET Compact Framework によってサポートされています。 |
参照- DataAdapter.FillSchemaのページへのリンク
