IColumnMapping Schnittstelle

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Quelle:

IColumnMapping.cs

Ordnet eine Datenquellenspalte einer DataSet Spalte zu und wird von der DataColumnMapping Klasse implementiert, die von .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 DataColumnMappingerstellt und einer 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

Die IColumnMapping Schnittstelle ermöglicht es einer geerbten Klasse, eine Column Mapping-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 IColumnMapping Schnittstelle direkt, sondern erstellt 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. Beispielsweise definiert die IColumnMapping Schnittstelle die DataSetColumn Eigenschaft. DataColumnMapping Die Klasse erbt wiederum 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 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

Name	Beschreibung
DataSetColumn	Ruft den Namen der Spalte innerhalb DataSet der zuzuordnenden Spalte ab oder legt diesen fest.
SourceColumn	Dient zum Abrufen oder Festlegen des Namens der Spalte innerhalb der Datenquelle, die zugeordnet werden soll. Bei dem Namen wird die Groß-/Kleinschreibung beachtet.