DataTableMappingCollection::GetTableMappingBySchemaAction Method (DataTableMappingCollection^, String^, String^, MissingMappingAction)
Gets a DataColumnMapping object with the specified source table name and DataSet table name, using the given MissingMappingAction.
Assembly: System.Data (in System.Data.dll)
public: static DataTableMapping^ GetTableMappingBySchemaAction( DataTableMappingCollection^ tableMappings, String^ sourceTable, String^ dataSetTable, MissingMappingAction mappingAction )
Parameters
- tableMappings
-
Type:
System.Data.Common::DataTableMappingCollection^
The DataTableMappingCollection collection to search.
- sourceTable
-
Type:
System::String^
The case-sensitive name of the mapped source table.
- dataSetTable
-
Type:
System::String^
The name, which is not case-sensitive, of the mapped DataSet table.
- mappingAction
-
Type:
System.Data::MissingMappingAction
One of the MissingMappingAction values.
| Exception | Condition |
|---|---|
| InvalidOperationException | The mappingAction parameter was set to Error, and no mapping was specified. |
If the DataTableMapping exists in the collection, it is returned.
If the DataTableMapping does not exist in the collection for a given MissingMappingAction, the following happens:
MissingMappingAction | Action taken |
|---|---|
Passthrough | Creates a DataTableMapping object with the given sourceTable as the source table name and dataSetTable as the DataSet table name. The created DataTableMapping object is not added to the collection. |
Error | An exception is generated. The dataSetTable parameter is ignored. |
Ignore | Gets null. The dataSetTable parameter is ignored. |
The following example searches for a DataTableMapping with the given source table name within the collection. If the object exists, it is returned. The example assumes that a DataTableMappingCollection collection and a DataTableMapping object have been created.
Available since 1.1