IColumnMapping Schnittstelle

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: System.Data.Common.DataColumnMapping

Beispiele

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


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

Die IColumnMapping Schnittstelle ermöglicht eine erbende Klasse, um eine Spaltenzuordnungsklasse zu implementieren, die eine Datenquellenspalte mit einer DataSet Spalte verknüpft. Weitere Informationen finden Sie unter DataAdapter DataTable- und DataColumn-Zuordnungen.

Eine Anwendung erstellt keine Instanz der IColumnMapping Schnittstelle direkt, erstellt aber eine Instanz einer Klasse, die erbt IColumnMapping.

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 die IColumnMapping DataSetColumn Eigenschaft. Die Klasse erbt wiederum diese Eigenschaft und definiert auch die DataColumnMapping 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 Instanz der ColumnMapping-Klasse.
ColumnMapping(string sourceColumn, string dataSetColumn)	Initialisiert eine neue Instanz 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