IColumnMapping IColumnMapping IColumnMapping IColumnMapping Interface

Определение

Связывает столбец источника данных со столбцом объекта DataSet. Этот интерфейс реализуется классом DataColumnMapping, который совместно используется поставщиками данных .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
Производный

Примеры

В следующем примере создается экземпляр производного класса, DataColumnMappingи добавляет ее к DataColumnMappingCollection коллекции.The following example creates an instance of the derived class, DataColumnMapping, and adds it to a DataColumnMappingCollection collection. Затем пользователю сообщается, что сопоставление был добавлен в коллекцию и отображается родительский объект для сопоставления.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

Комментарии

IColumnMapping Интерфейс позволяет наследующему классу реализовать класс сопоставление столбцов, которая связывает столбец источника данных с помощью DataSet столбца.The IColumnMapping interface enables an inheriting class to implement a Column Mapping class, which associates a data source column with a DataSet column. Дополнительные сведения см. в разделе сопоставления DataAdapter DataTable и DataColumn.For more information, see DataAdapter DataTable and DataColumn Mappings.

Приложение не создает экземпляр IColumnMapping интерфейса напрямую, но создает экземпляр класса, наследующего IColumnMapping.An application does not create an instance of the IColumnMapping interface directly, but creates an instance of a class that inherits IColumnMapping.

Классы, наследующие IColumnMapping должен реализовывать все наследуемые члены и обычно определяются дополнительные члены для добавления функций конкретного поставщика.Classes that inherit IColumnMapping must implement all inherited members, and typically define additional members to add provider-specific functionality. Например IColumnMapping интерфейс определяет DataSetColumn свойство.For example, the IColumnMapping interface defines the DataSetColumn property. В свою очередь DataColumnMapping класс наследует это свойство, а также определяет GetDataColumnBySchemaAction метод.In turn, the DataColumnMapping class inherits this property, and also defines the GetDataColumnBySchemaAction method.

Примечания для тех, кто реализует этот метод

При наследовании от IColumnMapping интерфейса, следует реализовать следующие конструкторы:When you inherit from the IColumnMapping interface, you should implement the following constructors:

ЭлементItem ОписаниеDescription
ColumnMapping()ColumnMapping() Инициализирует новый экземпляр класса ColumnMapping.Initializes a new instance of the ColumnMapping class.

ColumnMapping (sourceColumn строка, строка dataSetColumn)ColumnMapping(string sourceColumn, string dataSetColumn) Инициализирует новый экземпляр класса ColumnMapping с источника с указанным именем исходного столбца и DataSet имя столбца.Initializes a new instance of the ColumnMapping class with a source with the specified source column name and DataSet column name.

Свойства

DataSetColumn DataSetColumn DataSetColumn DataSetColumn

Возвращает или задает имя столбца в объекте DataSet для сопоставления.Gets or sets the name of the column within the DataSet to map to.

SourceColumn SourceColumn SourceColumn SourceColumn

Возвращает или задает имя столбца в источнике данных для сопоставления.Gets or sets the name of the column within the data source to map from. Имя указано с учетом регистра.The name is case-sensitive.

Применяется к