IColumnMapping Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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. |