ITableMapping インターフェイス


ソース テーブルを DataSet 内のテーブルと関連付けます。.NET データ プロバイダーによって共通に使用される DataTableMapping クラスによって実装されます。Associates a source table with a table in a DataSet, and is implemented by the DataTableMapping class, which is used in common by .NET data providers.

public interface class ITableMapping
public interface ITableMapping
type ITableMapping = interface
Public Interface ITableMapping

次の例では、派生クラスのインスタンスを作成 DataTableMapping し、それをコレクションに追加し DataTableMappingCollection ます。The following example creates an instance of the derived class, DataTableMapping, and adds it to a DataTableMappingCollection collection. 次に、マッピングがコレクションに追加されたことをユーザーに通知し、親マッピングを表示します。It then informs the user that the mapping was added to the collection and displays the parent mapping.

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());
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


ITableMappingインターフェイスを使用すると、継承クラスで TableMapping クラスを実装できます。これにより、データソース列が列に関連付けら DataSet れます。The ITableMapping interface allows an inheriting class to implement a TableMapping class, which associates a data source column with a DataSet column. 詳細については、「 DataAdapter DataTable」と「DataColumn Mappings」を参照してください。For more information, see DataAdapter DataTable and DataColumn Mappings.

アプリケーションは、インターフェイスのインスタンスを直接作成するのではなく ITableMapping 、を継承するクラスのインスタンスを作成し ITableMapping ます。An application does not create an instance of the ITableMapping interface directly, but creates an instance of a class that inherits ITableMapping.

ITableMapping を継承するクラスは、継承されたメンバーを実装し、通常は、プロバイダー固有の機能を追加するための追加メンバーを定義する必要があります。Classes that inherit ITableMapping must implement the inherited members, and typically define additional members to add provider-specific functionality. たとえば、インターフェイスは ITableMapping プロパティを定義し DataSetTable ます。For example, the ITableMapping interface defines the DataSetTable property. 次に、 DataTableMapping クラスはこのプロパティを継承し、メソッドも定義し GetDataTableBySchemaAction ます。In turn, the DataTableMapping class inherits this property, and also defines the GetDataTableBySchemaAction method.

注意 (実装者)

インターフェイスから継承する場合は、 ITableMapping 次のコンストラクターを実装する必要があります。When you inherit from the ITableMapping interface, you should implement the following constructors:

アイテムItem 説明Description
DataTableMapping ()DataTableMapping() TableMapping クラスの新しいインスタンスを初期化します。Initializes a new instance of the TableMapping class.
TableMapping (string sourceTable、string dataSetTable 可能)TableMapping(string sourceTable, string dataSetTable) ソーステーブル名と名前が指定された場合に、ソースを使用して TableMapping クラスの新しいインスタンスを初期化し DataTable ます。Initializes a new instance of the TableMapping class with a source when given a source table name and a DataTable name.
TableMapping (string sourceTable、string dataSetTable 可能、DataColumnMapping [] columnMappings)TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings) ソーステーブル名、 DataTable 名前、および ColumnMapping オブジェクトの配列が指定されている場合に、TableMapping クラスの新しいインスタンスを初期化します。Initializes a new instance of the TableMapping class when given a source table name, a DataTable name, and an array of ColumnMapping objects.



DataColumnMappingCollection の派生 DataTable を取得します。Gets the derived DataColumnMappingCollection for the DataTable.


DataSet 内にあるテーブルの、大文字と小文字が区別されない名前を取得または設定します。Gets or sets the case-insensitive name of the table within the DataSet.


ソース テーブルの、大文字と小文字が区別される名前を取得または設定します。Gets or sets the case-sensitive name of the source table.