IColumnMapping Interface

Définition

Associe une colonne source de données à une colonne DataSet et est implémenté par la classe DataColumnMapping, qui est utilisée en commun par les fournisseurs de données .NET Framework.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
Dérivé

Exemples

L’exemple suivant crée une instance de la classe dérivée DataColumnMapping, et l’ajoute à une DataColumnMappingCollection collection.The following example creates an instance of the derived class, DataColumnMapping, and adds it to a DataColumnMappingCollection collection. Il indique ensuite à l’utilisateur que le mappage a été ajouté à la collection et affiche le parent pour le mappage.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

Remarques

L' IColumnMapping interface permet à une classe qui hérite d’implémenter une classe de mappage de colonnes, qui associe DataSet une colonne de source de données à une colonne.The IColumnMapping interface enables an inheriting class to implement a Column Mapping class, which associates a data source column with a DataSet column. Pour plus d’informations, consultez mappages DataAdapter DataTable et DataColumn.For more information, see DataAdapter DataTable and DataColumn Mappings.

Une application ne crée pas directement une instance de IColumnMapping l’interface, mais crée une instance d’une classe qui IColumnMappinghérite de.An application does not create an instance of the IColumnMapping interface directly, but creates an instance of a class that inherits IColumnMapping.

Les classes qui IColumnMapping héritent doivent implémenter tous les membres hérités et, en général, définissent des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur.Classes that inherit IColumnMapping must implement all inherited members, and typically define additional members to add provider-specific functionality. Par exemple, l' IColumnMapping interface définit la DataSetColumn propriété.For example, the IColumnMapping interface defines the DataSetColumn property. À son tour, DataColumnMapping la classe hérite de cette propriété et définit également GetDataColumnBySchemaAction la méthode.In turn, the DataColumnMapping class inherits this property, and also defines the GetDataColumnBySchemaAction method.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de IColumnMapping l’interface, vous devez implémenter les constructeurs suivants:When you inherit from the IColumnMapping interface, you should implement the following constructors:

ÉlémentItem DescriptionDescription
ColumnMapping()ColumnMapping() Initialise une nouvelle instance de la classe ColumnMapping.Initializes a new instance of the ColumnMapping class.
ColumnMapping (String sourceColumn, String dataSetColumn)ColumnMapping(string sourceColumn, string dataSetColumn) Initialise une nouvelle instance de la classe ColumnMapping avec une source avec le nom de colonne source et DataSet le nom de colonne spécifiés.Initializes a new instance of the ColumnMapping class with a source with the specified source column name and DataSet column name.

Propriétés

DataSetColumn

Obtient ou définit le nom de la colonne dans le DataSet auquel effectuer le mappage.Gets or sets the name of the column within the DataSet to map to.

SourceColumn

Obtient ou définit le nom de la colonne dans la source de données à partir de laquelle effectuer le mappage.Gets or sets the name of the column within the data source to map from. Le nom respecte la casse.The name is case-sensitive.

S’applique à