ITableMapping Interface

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Associa uma tabela de origem a uma tabela em um DataSet e é implementado pela classe DataTableMapping, que é usada em comum por provedores de dados .NET.

public interface class ITableMapping

public interface ITableMapping

type ITableMapping = interface

Public Interface ITableMapping

Derivado

System.Data.Common.DataTableMapping

Exemplos

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

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

Comentários

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

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

Notas aos Implementadores

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

Item	Descrição
DataTableMapping()	Inicializa uma nova instância da classe TableMapping.
TableMapping(string sourceTable, string dataSetTable)	Inicializa uma nova instância da classe TableMapping com uma origem quando um nome e um DataTable nome de tabela de origem são fornecidos.
TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings)	Inicializa uma nova instância da classe TableMapping quando receber um nome de tabela de origem, um DataTable nome e uma matriz de objetos ColumnMapping.

Propriedades

ColumnMappings	Obtém o DataColumnMappingCollection derivado para o DataTable.
DataSetTable	Obtém ou define o nome que não diferencia maiúsculas e minúsculas da tabela dentro do DataSet.
SourceTable	Obtém ou define o nome que diferencia maiúsculas e minúsculas da tabela de origem.

Confira também

• ITableMappingCollection