ITableMapping Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Kojarzy tabelę źródłową z tabelą DataSetw obiekcie i jest implementowana przez DataTableMapping klasę, która jest używana przez dostawców danych platformy .NET.
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 , DataTableMappingi dodaje je do DataTableMappingCollection kolekcji. Następnie informuje użytkownika, że mapowanie zostało dodane do kolekcji i wyświetla mapowanie nadrzędne.
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
Interfejs ITableMapping umożliwia dziedziczącej klasie zaimplementowanie klasy TableMapping, która kojarzy kolumnę źródła danych z kolumną DataSet . Aby uzyskać więcej informacji, zobacz DataAdapter DataTable i DataColumn Mappings (Mapowania kolumn danych).
Aplikacja nie tworzy bezpośrednio wystąpienia interfejsu ITableMapping , ale tworzy wystąpienie klasy dziedziczonej ITableMapping.
Klasy dziedziczone ITableMapping muszą implementować dziedziczone elementy członkowskie i zwykle definiują dodatkowe elementy członkowskie w celu dodania funkcji specyficznych dla dostawcy. Na przykład ITableMapping interfejs definiuje DataSetTable właściwość . Z kolei DataTableMapping klasa dziedziczy tę właściwość, a także definiuje metodę GetDataTableBySchemaAction .
Uwagi dotyczące implementowania
Podczas dziedziczenia z interfejsu ITableMapping należy zaimplementować następujące konstruktory:
Element | Opis |
---|---|
DataTableMapping() | Inicjuje nowe wystąpienie klasy TableMapping. |
TableMapping(ciąg sourceTable, ciąg dataSetTable) | Inicjuje nowe wystąpienie klasy TableMapping ze źródłem, gdy podano nazwę tabeli źródłowej i DataTable nazwę. |
TableMapping(ciąg sourceTable, ciąg dataSetTable, DataColumnMapping[] columnMappings) | Inicjuje nowe wystąpienie klasy TableMapping, gdy podano nazwę tabeli źródłowej, DataTable nazwę i tablicę obiektów ColumnMapping. |
Właściwości
ColumnMappings |
Pobiera wartość pochodną DataColumnMappingCollection dla .DataTable |
DataSetTable |
Pobiera lub ustawia nazwę tabeli bez uwzględniania wielkości liter w tabeli DataSet. |
SourceTable |
Pobiera lub ustawia nazwę tabeli źródłowej z uwzględnieniem wielkości liter. |