ITableMapping Schnittstelle

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

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

Beispiele

Im folgenden Beispiel wird eine instance der abgeleiteten Klasse erstellt und DataTableMappingeiner DataTableMappingCollection Auflistung hinzugefügt. Anschließend wird der Benutzer darüber informiert, dass die Zuordnung der Auflistung 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 erbenden Klasse, eine TableMapping-Klasse zu implementieren, die eine Datenquellenspalte einer DataSet Spalte ordnet. Weitere Informationen finden Sie unter DataAdapter DataTable- und DataColumn-Zuordnungen.

Eine Anwendung erstellt nicht direkt einen instance der ITableMapping Schnittstelle, sondern erstellt eine instance einer Klasse, die erbtITableMapping.

Klassen, die erben ITableMapping , müssen die geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Die -Schnittstelle definiert beispielsweise ITableMapping die DataSetTable -Eigenschaft. Die -Klasse erbt wiederum DataTableMapping 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 instance der TableMapping-Klasse.
TableMapping(string sourceTable, string dataSetTable) Initialisiert einen neuen instance 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 instance der TableMapping-Klasse, wenn ein Quelltabellenname, ein DataTable Name und ein Array von ColumnMapping-Objekten angegeben wird.

Eigenschaften

ColumnMappings

Ruft die abgeleitete DataColumnMappingCollection-Klasse für die DataTable-Klasse ab.
DataSetTable

Ruft den Namen der Tabelle in DataSet ohne Berücksichtigung von Groß- und Kleinschreibung ab oder legt diesen fest.
SourceTable

Ruft den Namen der Quelltabelle unter Berücksichtigung von Groß- und Kleinschreibung ab oder legt diesen fest.

Gilt für:

Weitere Informationen