IColumnMapping Schnittstelle

  • Referenz

Definition

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

Ordnet einer DataSet-Spalte eine Spalte einer Datenquelle zu und wird von der DataColumnMapping-Klasse implementiert, die von allen .NET-Datenanbietern gemeinsam verwendet wird.

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

Beispiele

Im folgenden Beispiel wird eine instance der abgeleiteten Klasse erstellt und DataColumnMappingeiner DataColumnMappingCollection Auflistung hinzugefügt. Anschließend wird dem Benutzer mitgeteilt, dass die Zuordnung der Auflistung hinzugefügt wurde, und zeigt das übergeordnete Element für die Zuordnung an.


public void AddDataColumnMapping() {
   // ...
   // create columnMappings
   // ...
   DataColumnMapping mapping =
      new DataColumnMapping("Description","DataDescription");
   columnMappings.Add((Object) mapping);
   Console.WriteLine("Column {0} added to column mapping collection {1}.",
       mapping.ToString(), columnMappings.ToString());
}

Public Sub AddDataColumnMapping()
    ' ...
    ' create columnMappings
    ' ...
    Dim mapping As New DataColumnMapping( _
       "Description", "DataDescription")
    columnMappings.Add(CType(mapping, Object))
    Console.WriteLine("Column {0} added to column mapping collection {1}.", _
       mapping.ToString(), columnMappings.ToString())
End Sub

Hinweise

Mit IColumnMapping der Schnittstelle kann eine erbende Klasse eine Column Mapping-Klasse 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 IColumnMapping Schnittstelle, sondern erstellt eine instance einer Klasse, die erbtIColumnMapping.

Klassen, die erben IColumnMapping , müssen alle geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Die -Schnittstelle definiert beispielsweise IColumnMapping die DataSetColumn -Eigenschaft. Die -Klasse erbt wiederum DataColumnMapping diese Eigenschaft und definiert auch die GetDataColumnBySchemaAction -Methode.

Hinweise für Ausführende

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

Element Beschreibung
ColumnMapping() Initialisiert eine neue instance der ColumnMapping-Klasse.
ColumnMapping(string sourceColumn, string dataSetColumn) Initialisiert eine neue instance der ColumnMapping-Klasse mit einer Quelle mit dem angegebenen Quellspaltennamen und DataSet Spaltennamen.

Eigenschaften

DataSetColumn

Ruft den Namen der Spalte in dem DataSet ab, für das die Zuordnung erfolgen soll, oder legt diesen fest.
SourceColumn

Ruft den Namen der Spalte in der Datenquelle ab, aus der die Zuordnung erfolgen soll, oder legt diesen fest. Bei dem Namen wird die Groß- und Kleinschreibung berücksichtigt.

Gilt für: