System.Data Namespace

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.

The ITableMapping interface allows an inheriting class to implement a TableMapping class, which associates a data source column with a DataSet column. For more information, see Setting Up DataTable and DataColumn Mappings.

An application does not create an instance of the ITableMapping interface directly, but initializes an instance of a class that inherits ITableMapping.

Classes that inherit ITableMapping must implement the inherited members, and typically define additional members to add provider-specific functionality. For example, the ITableMapping interface defines the DataSetTable property. In turn, the DataTableMapping class inherits this property, and also defines the GetDataTableBySchemaAction method.

Notes to Implementers: When you inherit from the ITableMapping interface, you should implement the following constructors:

The following example initializes an instance of the derived class, DataTableMapping, and adds it to a DataTableMappingCollection . It then informs the user that the mapping was added to the collection and displays the Parent property.

void AddDataTableMapping ( ) {

   // ... create myTableMappings ...
   DataTableMapping myNewMapping = 
     new DataTableMapping ( "Categories","DataCategories" );
   myTableMappings.Add ( ( Object ) myNewMapping );
   Response.Write ( "Table " + myNewMapping.ToString ( ) + 
     " added to " + "table mapping collection " + 
     myTableMappings.ToString ( ) );
}

Public Sub AddDataTableMapping ( )

   ' ... create myTableMappings ...
   Dim myNewMapping As New _
     DataTableMapping ( "Categories", "DataCategories" )
   myTableMappings.Add ( CType ( myNewMapping, Object ) )
   Response.Write ( "Table " & myNewMapping.ToString ( ) & _
     " added to " & "table mapping collection " & _
      myTableMappings.ToString ( ) )
End Sub

ITableMappingCollection