DataTableMappingCollection.GetTableMappingBySchemaAction-Methode

Artikel
08/20/2007

Ruft unter Verwendung der angegebenen MissingMappingAction ein DataColumnMapping-Objekt mit dem angegebenen Quelltabellennamen und DataSet-Tabellennamen ab.

Namespace: System.Data.Common
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Shared Function GetTableMappingBySchemaAction ( _
    tableMappings As DataTableMappingCollection, _
    sourceTable As String, _
    dataSetTable As String, _
    mappingAction As MissingMappingAction _
) As DataTableMapping
'Usage
Dim tableMappings As DataTableMappingCollection
Dim sourceTable As String
Dim dataSetTable As String
Dim mappingAction As MissingMappingAction
Dim returnValue As DataTableMapping

returnValue = DataTableMappingCollection.GetTableMappingBySchemaAction(tableMappings, sourceTable, dataSetTable, mappingAction)

public static DataTableMapping GetTableMappingBySchemaAction (
    DataTableMappingCollection tableMappings,
    string sourceTable,
    string dataSetTable,
    MissingMappingAction mappingAction
)

public:
static DataTableMapping^ GetTableMappingBySchemaAction (
    DataTableMappingCollection^ tableMappings, 
    String^ sourceTable, 
    String^ dataSetTable, 
    MissingMappingAction mappingAction
)

public static DataTableMapping GetTableMappingBySchemaAction (
    DataTableMappingCollection tableMappings, 
    String sourceTable, 
    String dataSetTable, 
    MissingMappingAction mappingAction
)

public static function GetTableMappingBySchemaAction (
    tableMappings : DataTableMappingCollection, 
    sourceTable : String, 
    dataSetTable : String, 
    mappingAction : MissingMappingAction
) : DataTableMapping

Parameter

tableMappings
Die zu durchsuchende DataTableMappingCollection-Auflistung.

sourceTable
Der Name der zugeordneten Quelltabelle mit Berücksichtigung von Groß- und Kleinschreibung.

dataSetTable
Der Name der zugeordneten DataSet-Tabelle ohne Berücksichtigung von Groß- und Kleinschreibung.

mappingAction
Einer der MissingMappingAction-Werte.

Rückgabewert

Ein DataTableMapping-Objekt.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Der mappingAction-Parameter wurde auf Error festgelegt, und es wurde keine Zuordnung angegeben.

Hinweise

Wenn die DataTableMapping in der Auflistung vorhanden ist, wird sie zurückgegeben.

Wenn die DataTableMapping für eine angegebene MissingMappingAction in der Auflistung nicht vorhanden ist, werden folgende Aktionen ausgeführt:

MissingMappingAction	Ausgeführte Aktion
Passthrough	Erstellt ein DataTableMapping-Objekt mit der angegebenen sourceTable als Quelltabellenname und mit dataSetTable als DataSet-Tabellenname. Das erstellte DataTableMapping-Objekt wird der Auflistung nicht hinzugefügt.
Error	Es wird eine Ausnahme ausgelöst. Der dataSetTable-Parameter wird ignoriert.
Ignore	Ruft NULL (Nothing in Visual Basic) ab. Der dataSetTable-Parameter wird ignoriert.

Beispiel

Im folgenden Beispiel wird die Auflistung nach einer DataTableMapping mit dem angegebenen Quelltabellennamen durchsucht. Wenn das Objekt vorhanden ist, wird es zurückgegeben. In diesem Beispiel wird davon ausgegangen, dass eine DataTableMappingCollection-Auflistung und ein DataTableMapping-Objekt erstellt wurden.

Public Sub FindDataTableMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Categories") Then
        mapping = _
           DataTableMappingCollection.GetTableMappingBySchemaAction _
           (mappings, "Categories", "", MissingMappingAction.Ignore)
    End If
End Sub

public void FindDataTableMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Categories")) 
    {
        mapping = DataTableMappingCollection.GetTableMappingBySchemaAction
            (mappings, "Categories", "", MissingMappingAction.Ignore);
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataTableMappingCollection-Klasse
DataTableMappingCollection-Member
System.Data.Common-Namespace

Freigeben über