ITableMapping Interface

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Associa uma tabela de origem a uma tabela num DataSet, e é implementada pela classe DataTableMapping, que é usada em comum por .NET fornecedores de dados.

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

Exemplos

O exemplo seguinte cria uma instância da classe derivada, DataTableMapping, e adiciona-a a uma DataTableMappingCollection coleção. Informa então o utilizador que o mapeamento foi adicionado à coleção e apresenta o mapeamento principal.

public void AddDataTableMapping()
{
    // ...
    // create tableMappings
    // ...
    DataTableMapping mapping =
        new DataTableMapping("Categories","DataCategories");
    tableMappings.Add((Object) mapping);
    Console.WriteLine("Table {0} added to {1} table mapping collection.",
        mapping.ToString(), tableMappings.ToString());
}

Public Sub AddDataTableMapping()
    ' ...
    ' create tableMappings
    ' ...
    Dim mapping As New DataTableMapping( _
       "Categories", "DataCategories")
    tableMappings.Add(CType(mapping, Object))
    Console.WriteLine( _
       "Table {0} added to {1} table mapping collection.", _
       mapping.ToString(), tableMappings.ToString())
End Sub

Observações

A ITableMapping interface permite que uma classe herdeira implemente uma classe TableMapping, 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 ITableMapping interface, mas cria uma instância de uma classe que herda ITableMapping.

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

Notas para Implementadores

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

Número Descrição
DataTableMapping() Inicializa uma nova instância da classe TableMapping.
TableMapping(stringSourceTable, string dataSetTable) Inicializa uma nova instância da classe TableMapping com uma fonte quando recebe um nome de tabela de origem e um DataTable nome.
TableMapping(stringSourceTable, string dataSetTable, DataColumnMapping[] columnMappings) Inicializa uma nova instância da classe TableMapping quando recebe um nome de tabela de origem, um DataTable nome e um array de objetos ColumnMapping.

Propriedades

Name Description
ColumnMappings

Obtém o derivado DataColumnMappingCollection para o DataTable.
DataSetTable

Obtém ou define o nome insensível a maiúsculas e minúsculas da tabela dentro do DataSet.
SourceTable

Obtém ou define o nome distinto a maiúsculas minúsculas da tabela de origem.

Aplica-se a

Ver também