.NET Framework Class Library ITableMapping Interface 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. (in System.Data.dll)
Syntax
Public Interface ITableMapping
public interface ITableMapping
public interface class ITableMapping
type ITableMapping = interface end
The ITableMapping type exposes the following members.
Properties
Remarks
The ITableMapping interface allows an inheriting class to implement a TableMapping class, which associates a data source column with a DataSet column. For more information, see DataAdapter DataTable and DataColumn Mappings (ADO.NET). An application does not create an instance of the ITableMapping interface directly, but creates an instance of a class that inherits ITableMapping. Classes that inherit ITableMapping must implement the inherited members, and typically define additional members to add provider-specific functionality. For example, the ITableMapping interface defines the DataSetTable property. In turn, the DataTableMapping class inherits this property, and also defines the GetDataTableBySchemaAction method. Notes to ImplementersWhen you inherit from the ITableMapping interface, you should implement the following constructors: Item | Description |
|---|
DataTableMapping() | Initializes a new instance of the TableMapping class. | TableMapping(string sourceTable, string dataSetTable) | Initializes a new instance of the TableMapping class with a source when given a source table name and a DataTable name. | TableMapping(string sourceTable, string dataSetTable, DataColumnMapping[] columnMappings) | Initializes a new instance of the TableMapping class when given a source table name, a DataTable name, and an array of ColumnMapping objects. |
Examples
The following example creates an instance of the derived class, DataTableMapping, and adds it to a DataTableMappingCollection collection. It then informs the user that the mapping was added to the collection and displays the parent mapping.
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
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());
}
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0 .NET Framework Client ProfileSupported in: 4, 3.5 SP1
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also
|
Biblioteca de clases de .NET Framework ITableMapping (Interfaz) 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. (en System.Data.dll)
Sintaxis
Public Interface ITableMapping
public interface ITableMapping
public interface class ITableMapping
type ITableMapping = interface end
El tipo ITableMapping expone los siguientes miembros.
Propiedades
Comentarios
La interfaz ITableMapping permite que una clase heredada implemente una clase TableMapping, que asocia una columna del origen de datos a una columna del DataSet. Para obtener más información, vea Asignaciones DataAdapter, DataTable y DataColumn (ADO.NET). Una aplicación no crea una instancia de la interfaz ITableMapping directamente, sino que la crea de una clase que hereda de ITableMapping. Las clases que heredan de ITableMapping deben implementar los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor. Por ejemplo, la interfaz ITableMapping define la propiedad DataSetTable. A su vez, la clase DataTableMapping hereda esta propiedad y también define el método GetDataTableBySchemaAction. Notas para los implementadoresAl heredar de la interfaz ITableMapping, se deben implementar los siguientes constructores: Elemento | Descripción |
|---|
DataTableMapping() | Inicializa una nueva instancia de la clase TableMapping. | 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. | 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. |
Ejemplos
En el ejemplo siguiente se crea una instancia de la clase derivada DataTableMapping y se agrega a una colección DataTableMappingCollection. A continuación, se informa al usuario de que se ha agregado la asignación a la colección y se muestra la asignación del objeto primario.
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
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());
}
Información de versión
.NET FrameworkCompatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0 .NET Framework Client ProfileCompatible con: 4, 3.5 SP1
Plataformas
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Vea también
|