ITableMapping インターフェイス

.NET Framework クラス ライブラリ リファレンス

ITableMapping インターフェイス

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

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

Visual Basic (宣言)

Public Interface ITableMapping

Visual Basic (使用法)

Dim instance As ITableMapping

C#

public interface ITableMapping

C++

public interface class ITableMapping

J#

public interface ITableMapping

JScript

public interface ITableMapping

解説

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 クラスの新しいインスタンスを初期化します。

使用例

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

Visual Basic

Public Sub AddDataTableMapping()
    ' ...
    ' create tableMappings
    ' ...
    Dim mapping As New DataTableMapping(
 _
       "Categories", "DataCategories")
    tableMappings.Add(CType(mapping, Object))
    Console.WriteLine( _
       "Table {0} added to {1} table mapping collection.",
 _
       mapping.ToString(), tableMappings.ToString())
End Sub

C#

public void AddDataTableMapping() 
{
    // ...
    // create tableMappings
    // ...
    DataTableMapping mapping =
        new DataTableMapping("Categories","DataCategories");
    tableMappings.Add((Object) mapping);
    Console.WriteLine("Table {0} added to {1} table mapping collection."
,
        mapping.ToString(), tableMappings.ToString());
}

プラットフォーム

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

参照

関連項目
ITableMapping メンバ
System.Data 名前空間
ITableMappingCollection