ITableMapping Interfejs

Definicja

Kojarzy tabelę źródłową z tabelą w DataSet i, która jest implementowana przez DataTableMapping klasę, która jest używana wspólnie przez dostawców danych programu .NET.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
Pochodne

Przykłady

Poniższy przykład tworzy wystąpienie klasy pochodnej DataTableMapping i dodaje je do DataTableMappingCollection kolekcji.The following example creates an instance of the derived class, DataTableMapping, and adds it to a DataTableMappingCollection collection. Następnie informuje użytkownika o tym, że mapowanie zostało dodane do kolekcji, i wyświetla mapowanie nadrzędne.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

Uwagi

ITableMappingInterfejs umożliwia dziedziczenie klasy w celu zaimplementowania klasy elementu TableMapping, która kojarzy kolumnę źródła danych z DataSet kolumną.The ITableMapping interface allows an inheriting class to implement a TableMapping class, which associates a data source column with a DataSet column. Aby uzyskać więcej informacji, zobacz mapowania DataAdapter DataTable i DataColumn.For more information, see DataAdapter DataTable and DataColumn Mappings.

Aplikacja nie tworzy wystąpienia ITableMapping interfejsu bezpośrednio, ale tworzy wystąpienie klasy, która dziedziczy ITableMapping .An application does not create an instance of the ITableMapping interface directly, but creates an instance of a class that inherits ITableMapping.

Klasy dziedziczące ITableMapping muszą implementować dziedziczone elementy członkowskie i zwykle definiują dodatkowe elementy członkowskie do dodawania funkcji specyficznych dla dostawcy.Classes that inherit ITableMapping must implement the inherited members, and typically define additional members to add provider-specific functionality. Na przykład ITableMapping Interfejs definiuje DataSetTable Właściwość.For example, the ITableMapping interface defines the DataSetTable property. Z kolei DataTableMapping Klasa dziedziczy tę właściwość, a także definiuje GetDataTableBySchemaAction metodę.In turn, the DataTableMapping class inherits this property, and also defines the GetDataTableBySchemaAction method.

Uwagi dotyczące implementowania

W przypadku dziedziczenia z ITableMapping interfejsu należy zaimplementować następujące konstruktory:When you inherit from the ITableMapping interface, you should implement the following constructors:

ElementItem OpisDescription
DataTableMapping()DataTableMapping() Inicjuje nowe wystąpienie klasy elementu TableMapping.Initializes a new instance of the TableMapping class.
Elementu TableMapping (Źródło ciągów, zestaw danych ciągów)TableMapping(string sourceTable, string dataSetTable) Inicjuje nowe wystąpienie klasy elementu TableMapping ze źródłem, gdy podaną nazwę tabeli źródłowej i DataTable nazwę.Initializes a new instance of the TableMapping class with a source when given a source table name and a DataTable name.
Elementu TableMapping (ciąg sources, String dataSet, DataColumnMapping [] columnMappings)TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings) Inicjuje nowe wystąpienie klasy elementu TableMapping, gdy podaną nazwę tabeli źródłowej, DataTable nazwę i tablicę obiektów ColumnMapping.Initializes a new instance of the TableMapping class when given a source table name, a DataTable name, and an array of ColumnMapping objects.

Właściwości

ColumnMappings

Pobiera pochodne DataColumnMappingCollection dla DataTable .Gets the derived DataColumnMappingCollection for the DataTable.

DataSetTable

Pobiera lub ustawia nazwę tabeli w elemencie DataSet .Gets or sets the case-insensitive name of the table within the DataSet.

SourceTable

Pobiera lub ustawia nazwę z uwzględnieniem wielkości liter tabeli źródłowej.Gets or sets the case-sensitive name of the source table.

Dotyczy

Zobacz też