ITableMapping Interfaz

Definición

Asocia una tabla de origen a una tabla de DataSet. La implementa la clase DataTableMapping, que utilizan todos los proveedores de datos de .NET Framework.Associates a source table with a table in a DataSet, and is implemented by the DataTableMapping class, which is used in common by .NET Framework data providers.

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

Ejemplos

En el ejemplo siguiente se crea una instancia de la clase derivada DataTableMappingy se agrega a una colección DataTableMappingCollection.The following example creates an instance of the derived class, DataTableMapping, and adds it to a DataTableMappingCollection collection. A continuación, informa al usuario de que la asignación se ha agregado a la colección y muestra la asignación primaria.It then informs the user that the mapping was added to the collection and displays the parent mapping.

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

Comentarios

La interfaz de ITableMapping permite que una clase heredada implemente una clase TableMapping, que asocia una columna de origen de datos a una columna de DataSet.The ITableMapping interface allows an inheriting class to implement a TableMapping class, which associates a data source column with a DataSet column. Para obtener más información, vea DataAdapter DataTable y las asignaciones DataColumn.For more information, see DataAdapter DataTable and DataColumn Mappings.

Una aplicación no crea una instancia de la interfaz ITableMapping directamente, sino que crea una instancia de una clase que hereda ITableMapping.An application does not create an instance of the ITableMapping interface directly, but creates an instance of a class that inherits ITableMapping.

Las clases que heredan ITableMapping deben implementar los miembros heredados y, normalmente, definir miembros adicionales para agregar funcionalidad específica del proveedor.Classes that inherit ITableMapping must implement the inherited members, and typically define additional members to add provider-specific functionality. Por ejemplo, la interfaz ITableMapping define la propiedad DataSetTable.For example, the ITableMapping interface defines the DataSetTable property. A su vez, la clase DataTableMapping hereda esta propiedad y también define el método GetDataTableBySchemaAction.In turn, the DataTableMapping class inherits this property, and also defines the GetDataTableBySchemaAction method.

Notas a los implementadores

Cuando herede de la interfaz ITableMapping, debe implementar los siguientes constructores:When you inherit from the ITableMapping interface, you should implement the following constructors:

ElementoItem DescripciónDescription
DataTableMapping()DataTableMapping() Inicializa una nueva instancia de la clase TableMapping.Initializes a new instance of the TableMapping class.
TableMapping (cadena sourceTable, cadena configurable)TableMapping(string sourceTable, string dataSetTable) Inicializa una nueva instancia de la clase TableMapping con un origen cuando se proporciona un nombre de tabla de origen y un nombre de DataTable.Initializes a new instance of the TableMapping class with a source when given a source table name and a DataTable name.
TableMapping (cadena sourceTable, cadena configurable, DataColumnMapping [] columnMappings)TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings) Inicializa una nueva instancia de la clase TableMapping cuando se proporciona un nombre de tabla de origen, un nombre de DataTable y una matriz de objetos ColumnMapping.Initializes a new instance of the TableMapping class when given a source table name, a DataTable name, and an array of ColumnMapping objects.

Propiedades

ColumnMappings

Obtiene el DataColumnMappingCollection derivado para el DataTable.Gets the derived DataColumnMappingCollection for the DataTable.

DataSetTable

Obtiene o establece el nombre, sin distinguir entre mayúsculas y minúsculas, de la tabla incluida en el DataSet.Gets or sets the case-insensitive name of the table within the DataSet.

SourceTable

Obtiene o establece el nombre, sin distinguir entre mayúsculas y minúsculas, de la tabla de origen.Gets or sets the case-sensitive name of the source table.

Se aplica a

Consulte también: