IColumnMapping Interface

Definição

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

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

Exemplos

O exemplo seguinte cria uma instância da classe derivada, DataColumnMapping, e adiciona-a a uma DataColumnMappingCollection coleção. Depois, informa o utilizador que o mapeamento foi adicionado à coleção e mostra o pai do 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

Observações

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

Uma aplicação não cria diretamente uma instância da IColumnMapping interface, mas cria uma instância de uma classe que herda IColumnMapping.

As classes que herdam IColumnMapping devem implementar todos os membros herdados, e normalmente definem membros adicionais para adicionar funcionalidades específicas do fornecedor. Por exemplo, a IColumnMapping interface define a DataSetColumn propriedade. Por sua vez, a DataColumnMapping classe herda esta propriedade e também define o GetDataColumnBySchemaAction método.

Notas para Implementadores

Quando herdas da IColumnMapping interface, deves implementar os seguintes construtores:

Número 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 fonte com o nome DataSet da coluna e o nome da coluna especificados.

Propriedades

Name Description
DataSetColumn

Obtém ou define o nome da coluna dentro do DataSet para mapear para.

SourceColumn

Obtém ou define o nome da coluna dentro da fonte de dados para mapear. O nome é sensível a maiúsculas e minúsculas.

Aplica-se a