ITableMapping インターフェイス

ソース テーブルに DataSet 内のテーブルを関連付けます。.NET Framework データ プロバイダが共通に使用する DataTableMapping クラスによって実装されます。

この型のすべてのメンバの一覧については、ITableMapping メンバ を参照してください。

Public Interface ITableMapping
[C#]
public interface ITableMapping
[C++]
public __gc __interface ITableMapping
[JScript]
public interface ITableMapping

ITableMapping を実装するクラス

クラス 説明
DataTableMapping ソース テーブルと DataTable との間に割り当てられた関係の記述を格納します。このクラスは、 DataSet にデータを格納するときに、 DataAdapter によって使用されます。

解説

ITableMapping インターフェイスによって、継承クラスはデータ ソース列に DataSet 列を関連付ける TableMapping クラスを実装できます。詳細については、「 DataTable と DataColumn のマップの設定 」を参照してください。

アプリケーションでは ITableMapping インターフェイスのインスタンスは直接作成されず、 ITableMapping を継承するクラスのインスタンスが作成されます。

ITableMapping を継承するクラスは、継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、 ITableMapping インターフェイスが DataSetTable プロパティを定義します。次に、 DataTableMapping クラスがこのプロパティを継承し、 GetDataTableBySchemaAction メソッドを定義します。

実装時の注意: ITableMapping インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。

項目 説明
DataTableMapping() TableMapping クラスの新しいインスタンスを初期化します。
TableMapping(string sourceTable, string dataSetTable) ソース テーブル名と DataTable 名が指定されている場合は、ソースを使用して TableMapping クラスの新しいインスタンスを初期化します。
TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings) ソース テーブル名、 DataTable 名、および ColumnMapping オブジェクトの配列が指定されている場合は、TableMapping クラスの新しいインスタンスを初期化します。

使用例

[Visual Basic, C#, C++] 派生クラスのインスタンス DataTableMapping を作成し、このインスタンスを DataTableMappingCollection コレクションに追加する例を次に示します。この例では、続いて、マップがコレクションに追加されたことをユーザーに通知し、親マップを表示します。

 
Public Sub AddDataTableMapping()
    ' ...
    ' create myTableMappings
    ' ...
    Dim myNewMapping As New DataTableMapping("Categories", "DataCategories")
    myTableMappings.Add(CType(myNewMapping, Object))
    MessageBox.Show("Table " + myNewMapping.ToString() + " added to " _
       + "table mapping collection " + myTableMappings.ToString())
End Sub

[C#] 
public void AddDataTableMapping() {
   // ...
   // create myTableMappings
   // ...
   DataTableMapping myNewMapping =
      new DataTableMapping("Categories","DataCategories");
   myTableMappings.Add((Object) myNewMapping);
   MessageBox.Show("Table " + myNewMapping.ToString() + " added to " +
      "table mapping collection " + myTableMappings.ToString());
}

[C++] 
void AddDataTableMapping() {
   // ...
   // create myTableMappings
   // ...
   DataTableMapping* myNewMapping =
      new DataTableMapping(S"Categories",S"DataCategories");
   myTableMappings->Add(static_cast<Object*>(myNewMapping));
   MessageBox::Show(String::Concat( S"Table ", myNewMapping->ToString(), S" added to ",
      S"table mapping collection ", myTableMappings->ToString() ));
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

名前空間: System.Data

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Data (System.Data.dll 内)

参照

ITableMapping メンバ | System.Data 名前空間 | ITableMappingCollection