DataTableMappingCollection.GetTableMappingBySchemaAction(DataTableMappingCollection, String, String, MissingMappingAction) Methode

Definition

Ruft unter Verwendung der angegebenen DataColumnMapping ein DataSet-Objekt mit dem angegebenen Quelltabellennamen und MissingMappingAction-Tabellennamen ab.Gets a DataColumnMapping object with the specified source table name and DataSet table name, using the given MissingMappingAction.

public:
 static System::Data::Common::DataTableMapping ^ GetTableMappingBySchemaAction(System::Data::Common::DataTableMappingCollection ^ tableMappings, System::String ^ sourceTable, System::String ^ dataSetTable, System::Data::MissingMappingAction mappingAction);
public static System.Data.Common.DataTableMapping GetTableMappingBySchemaAction (System.Data.Common.DataTableMappingCollection tableMappings, string sourceTable, string dataSetTable, System.Data.MissingMappingAction mappingAction);
static member GetTableMappingBySchemaAction : System.Data.Common.DataTableMappingCollection * string * string * System.Data.MissingMappingAction -> System.Data.Common.DataTableMapping
Public Shared Function GetTableMappingBySchemaAction (tableMappings As DataTableMappingCollection, sourceTable As String, dataSetTable As String, mappingAction As MissingMappingAction) As DataTableMapping

Parameter

tableMappings
DataTableMappingCollection

Die zu durchsuchende DataTableMappingCollection-Auflistung.The DataTableMappingCollection collection to search.

sourceTable
String

Der Name der zugeordneten Quelltabelle mit Berücksichtigung von Groß- und Kleinschreibung.The case-sensitive name of the mapped source table.

dataSetTable
String

Der Name der zugeordneten DataSet-Tabelle ohne Berücksichtigung von Groß- und Kleinschreibung.The name, which is not case-sensitive, of the mapped DataSet table.

mappingAction
MissingMappingAction

Einer der MissingMappingAction-Werte.One of the MissingMappingAction values.

Gibt zurück

Ausnahmen

Der mappingAction-Parameter wurde auf Error festgelegt, und es wurde keine Zuordnung angegeben.The mappingAction parameter was set to Error, and no mapping was specified.

Beispiele

Im folgenden Beispiel wird nach einer DataTableMapping mit dem angegebenen Quell Tabellennamen in der-Auflistung gesucht.The following example searches for a DataTableMapping with the given source table name within the collection. Wenn das Objekt vorhanden ist, wird es zurückgegeben.If the object exists, it is returned. Im Beispiel wird davon ausgegangen, dass eine DataTableMappingCollection-Auflistung und ein DataTableMapping-Objekt erstellt wurden.The example assumes that a DataTableMappingCollection collection and a DataTableMapping object have been created.

public void FindDataTableMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Categories")) 
    {
        mapping = DataTableMappingCollection.GetTableMappingBySchemaAction
            (mappings, "Categories", "", MissingMappingAction.Ignore);
    }
}
Public Sub FindDataTableMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Categories") Then
        mapping = _
           DataTableMappingCollection.GetTableMappingBySchemaAction _
           (mappings, "Categories", "", MissingMappingAction.Ignore)
    End If
End Sub

Hinweise

Wenn die DataTableMapping in der Auflistung vorhanden ist, wird Sie zurückgegeben.If the DataTableMapping exists in the collection, it is returned.

Wenn die DataTableMapping für eine angegebene MissingMappingActionnicht in der Sammlung vorhanden ist, geschieht Folgendes:If the DataTableMapping does not exist in the collection for a given MissingMappingAction, the following happens:

MissingMappingActionMissingMappingAction Ausgeführte AktionAction taken
Passthrough Erstellt ein DataTableMapping-Objekt mit dem angegebenen sourceTable als Quell Tabellennamen und dataSetTable als DataSet Tabellennamen.Creates a DataTableMapping object with the given sourceTable as the source table name and dataSetTable as the DataSet table name. Das erstellte DataTableMapping-Objekt wird der-Auflistung nicht hinzugefügt.The created DataTableMapping object is not added to the collection.
Error Es wird eine Ausnahme generiert.An exception is generated. Der dataSetTable-Parameter wird ignoriert.The dataSetTable parameter is ignored.
Ignore Ruft null ab.Gets null. Der dataSetTable-Parameter wird ignoriert.The dataSetTable parameter is ignored.

Gilt für: