IColumnMapping IColumnMapping IColumnMapping IColumnMapping Interface

Definition

Ordnet einer DataSet-Spalte eine Spalte einer Datenquelle zu und wird von der DataColumnMapping-Klasse implementiert, die von allen .NET Framework-Datenanbietern gemeinsam verwendet wird.Associates a data source column with a DataSet column, and is implemented by the DataColumnMapping class, which is used in common by .NET Framework data providers.

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

Beispiele

Im folgenden Beispiel wird eine Instanz der abgeleiteten-Klasse DataColumnMappingerstellt und einer DataColumnMappingCollection -Auflistung hinzugefügt.The following example creates an instance of the derived class, DataColumnMapping, and adds it to a DataColumnMappingCollection collection. Anschließend wird dem Benutzer mitgeteilt, dass die Zuordnung zur Auflistung hinzugefügt wurde, und das übergeordnete Element für die Zuordnung wird angezeigt.It then tells the user that the mapping was added to the collection and shows the parent for the mapping.


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 erbenden Klasse, eine Spalten Zuordnungen Klasse zu implementieren, die eine Daten DataSet Quellen Spalte mit einer Spalte verknüpft.The IColumnMapping interface enables an inheriting class to implement a Column Mapping class, which associates a data source column with a DataSet column. Weitere Informationen finden Sie unter DataAdapter-Datentabelle und datacolumschlag-Zuordnungen.For more information, see DataAdapter DataTable and DataColumn Mappings.

Eine Anwendung erstellt nicht direkt eine Instanz der IColumnMapping Schnittstelle, sondern erstellt eine Instanz einer Klasse, die erbt. IColumnMappingAn application does not create an instance of the IColumnMapping interface directly, but creates an instance of a class that inherits IColumnMapping.

Klassen, die IColumnMapping erben, müssen alle geerbten Member implementieren und in der Regel zusätzliche Elemente definieren, um anbieterspezifische Funktionen hinzuzufügen.Classes that inherit IColumnMapping must implement all inherited members, and typically define additional members to add provider-specific functionality. Die IColumnMapping -Schnittstelle definiert z. DataSetColumn b. die-Eigenschaft.For example, the IColumnMapping interface defines the DataSetColumn property. Wiederum erbt die DataColumnMapping -Klasse diese Eigenschaft und definiert auch die GetDataColumnBySchemaAction -Methode.In turn, the DataColumnMapping class inherits this property, and also defines the GetDataColumnBySchemaAction method.

Hinweise für Ausführende

Wenn Sie von der IColumnMapping -Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:When you inherit from the IColumnMapping interface, you should implement the following constructors:

ElementItem BeschreibungDescription
ColumnMapping ()ColumnMapping() Initialisiert eine neue Instanz der ColumnMapping-Klasse.Initializes a new instance of the ColumnMapping class.
ColumnMapping (Zeichenfolge sourcecolnumn, String DataSetColumn)ColumnMapping(string sourceColumn, string dataSetColumn) Initialisiert eine neue Instanz der ColumnMapping-Klasse mit einer Quelle mit dem angegebenen Quell Spaltennamen und DataSet Spaltennamen.Initializes a new instance of the ColumnMapping class with a source with the specified source column name and DataSet column name.

Eigenschaften

DataSetColumn DataSetColumn DataSetColumn DataSetColumn

Ruft den Namen der Spalte in dem DataSet ab, für das die Zuordnung erfolgen soll, oder legt diesen fest.Gets or sets the name of the column within the DataSet to map to.

SourceColumn SourceColumn SourceColumn SourceColumn

Ruft den Namen der Spalte in der Datenquelle ab, aus der die Zuordnung erfolgen soll, oder legt diesen fest.Gets or sets the name of the column within the data source to map from. Bei dem Namen wird die Groß- und Kleinschreibung berücksichtigt.The name is case-sensitive.

Gilt für: