ITableMapping Schnittstelle

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Quelle:

ITableMapping.cs

Ordnet eine Quelltabelle einer Tabelle in einem DataSet, und wird von der DataTableMapping Klasse implementiert, die von .NET-Datenanbietern verwendet wird.

public interface class ITableMapping

public interface ITableMapping

type ITableMapping = interface

Public Interface ITableMapping

Abgeleitet

System.Data.Common.DataTableMapping

Beispiele

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse DataTableMappingerstellt und einer DataTableMappingCollection Auflistung hinzugefügt. Anschließend wird der Benutzer darüber informiert, dass die Zuordnung der Sammlung hinzugefügt wurde, und zeigt die übergeordnete Zuordnung an.

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

Hinweise

Die ITableMapping Schnittstelle ermöglicht es einer geerbten Klasse, eine TableMapping-Klasse zu implementieren, die eine Datenquellenspalte einer DataSet Spalte zuordnet. Weitere Informationen finden Sie unter DataAdapter DataTable- und DataColumn-Zuordnungen.

Eine Anwendung erstellt keine Instanz der ITableMapping Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die erbt ITableMapping.

Klassen, die erben ITableMapping , müssen die geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Beispielsweise definiert die ITableMapping Schnittstelle die DataSetTable Eigenschaft. DataTableMapping Die Klasse erbt wiederum diese Eigenschaft und definiert auch die GetDataTableBySchemaAction Methode.

Hinweise für Ausführende

Wenn Sie von der ITableMapping Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:

Element	Beschreibung
DataTableMapping()	Initialisiert eine neue Instanz der TableMapping-Klasse.
TableMapping(string sourceTable, string dataSetTable)	Initialisiert eine neue Instanz der TableMapping-Klasse mit einer Quelle, wenn ein Quelltabellenname und ein DataTable Name angegeben wird.
TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings)	Initialisiert eine neue Instanz der TableMapping-Klasse bei Angabe eines Quelltabellennamens, eines DataTable Namens und eines Arrays von ColumnMapping-Objekten.

Eigenschaften

Name	Beschreibung
ColumnMappings	Ruft die abgeleitete DataColumnMappingCollection für die DataTable.
DataSetTable	Ruft den Namen der Tabelle innerhalb DataSetder Tabelle ab, oder legt den Namen der Groß-/Kleinschreibung fest.
SourceTable	Ruft den Namen der Quelltabelle ab, oder legt den Namen der Groß-/Kleinschreibung fest.

Weitere Informationen

• ITableMappingCollection