IColumnMapping Интерфейс

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Связывает столбец источника данных со столбцом DataSet. Этот интерфейс реализуется классом DataColumnMapping, который совместно используется поставщиками данных .NET.

public interface class IColumnMapping

public interface IColumnMapping

type IColumnMapping = interface

Public Interface IColumnMapping

Производный

System.Data.Common.DataColumnMapping

Примеры

В следующем примере создается экземпляр производного класса DataColumnMapping, и он добавляется в коллекцию DataColumnMappingCollection . Затем он сообщает пользователю, что сопоставление было добавлено в коллекцию, и отображает родительский объект для сопоставления.

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 . Дополнительные сведения см. в разделах DataAdapter DataTable и DataColumn Mappings.

Приложение не создает экземпляр IColumnMapping интерфейса напрямую, а создает экземпляр класса, наследующего IColumnMapping.

Классы, которые наследуются IColumnMapping , должны реализовывать все унаследованные члены и обычно определяют дополнительные члены для добавления функций, зависящих от поставщика. Например, IColumnMapping интерфейс определяет DataSetColumn свойство . В свою очередь, DataColumnMapping класс наследует это свойство, а также определяет GetDataColumnBySchemaAction метод .

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

При наследовании от IColumnMapping интерфейса необходимо реализовать следующие конструкторы:

Элемент	Описание
ColumnMapping()	Инициализирует новый экземпляр класса ColumnMapping.
ColumnMapping(string sourceColumn, string dataSetColumn)	Инициализирует новый экземпляр класса ColumnMapping с источником с указанным именем исходного столбца и DataSet именем столбца.

Свойства

DataSetColumn	Возвращает или задает имя столбца в объекте DataSet для сопоставления.
SourceColumn	Возвращает или задает имя столбца в источнике данных для сопоставления. Имя указано с учетом регистра.