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 provedores de dados .NET.Associates a data source column with a DataSet column, and is implemented by the DataColumnMapping class, which is used in common by .NET data providers.

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

Exemplos

O exemplo a seguir cria uma instância da classe derivada, DataColumnMapping e a adiciona a uma DataColumnMappingCollection coleção.The following example creates an instance of the derived class, DataColumnMapping, and adds it to a DataColumnMappingCollection collection. Em seguida, ele informa ao usuário que o mapeamento foi adicionado à coleção e mostra o pai do mapeamento.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

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.The IColumnMapping interface enables an inheriting class to implement a Column Mapping class, which associates a data source column with a DataSet column. Para obter mais informações, consulte os mapeamentos de DataAdapter DataTable e DataColumn.For more information, see DataAdapter DataTable and 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 .An application does not create an instance of the IColumnMapping interface directly, but creates an instance of a class that inherits IColumnMapping.

As classes que herdam IColumnMapping devem implementar todos os membros herdados e geralmente definem membros adicionais para adicionar funcionalidade específica do provedor.Classes that inherit IColumnMapping must implement all inherited members, and typically define additional members to add provider-specific functionality. Por exemplo, a IColumnMapping interface define a DataSetColumn propriedade.For example, the IColumnMapping interface defines the DataSetColumn property. Por sua vez, a DataColumnMapping classe herda essa propriedade e também define o GetDataColumnBySchemaAction método.In turn, the DataColumnMapping class inherits this property, and also defines the GetDataColumnBySchemaAction method.

Notas aos Implementadores

Ao herdar da IColumnMapping interface, você deve implementar os seguintes construtores:When you inherit from the IColumnMapping interface, you should implement the following constructors:

ItemItem DescriçãoDescription
ColumnMapping ()ColumnMapping() Inicializa uma nova instância da classe ColumnMapping.Initializes a new instance of the ColumnMapping class.
ColumnMapping (cadeia de Caracteres sourceColumn, Cadeia de Caracteres dataSetColumn)ColumnMapping(string sourceColumn, string dataSetColumn) Inicializa uma nova instância da classe ColumnMapping com uma origem com o nome da coluna de origem e o nome da coluna especificados DataSet .Initializes a new instance of the ColumnMapping class with a source with the specified source column name and DataSet column name.

Propriedades

DataSetColumn

Obtém ou define o nome da coluna dentro de DataSet para o qual mapear.Gets or sets the name of the column within the DataSet to map to.

SourceColumn

Obtém ou define o nome da coluna na fonte de dados da qual mapear.Gets or sets the name of the column within the data source to map from. O nome diferencia maiúsculas de minúsculas.The name is case-sensitive.

Aplica-se a