IColumnMapping Interface

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Associa uma coluna de fonte de dados a uma coluna DataSet e é implementado pela classe DataColumnMapping, que é usada em comum por provedores de dados .NET.

public interface class IColumnMapping

public interface IColumnMapping

type IColumnMapping = interface

Public Interface IColumnMapping

Derivado

System.Data.Common.DataColumnMapping

Exemplos

O exemplo a seguir cria uma instância da classe derivada , DataColumnMappinge a adiciona a uma DataColumnMappingCollection coleção. Em seguida, ele informa ao usuário que o mapeamento foi adicionado à coleção e mostra o pai para o mapeamento.

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

Comentários

A IColumnMapping interface permite que uma classe herdada implemente uma classe de Mapeamento de Coluna, que associa uma coluna de fonte de dados a uma DataSet coluna. Para obter mais informações, consulte DataAdapter DataTable e DataColumn Mappings.

Um aplicativo não cria uma instância da IColumnMapping interface diretamente, mas cria uma instância de uma classe que herda IColumnMapping.

As classes herdadas IColumnMapping devem implementar todos os membros herdados e normalmente definir membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a IColumnMapping interface define a DataSetColumn propriedade . Por sua vez, a DataColumnMapping classe herda essa propriedade e também define o GetDataColumnBySchemaAction método .

Notas aos Implementadores

Ao herdar da IColumnMapping interface, você deve implementar os seguintes construtores:

Item	Descrição
ColumnMapping()	Inicializa uma nova instância da classe ColumnMapping.
ColumnMapping(string sourceColumn, string dataSetColumn)	Inicializa uma nova instância da classe ColumnMapping com uma origem com o nome da coluna de origem e DataSet o nome da coluna especificados.

Propriedades

DataSetColumn	Obtém ou define o nome da coluna dentro de DataSet para o qual mapear.
SourceColumn	Obtém ou define o nome da coluna na fonte de dados da qual mapear. O nome diferencia maiúsculas de minúsculas.