DataColumnMappingCollection.GetColumnMappingBySchemaAction-Methode

Artikel
08/20/2007

Ruft eine DataColumnMapping für die angegebene DataColumnMappingCollection, den angegebenen Quellspaltennamen und die angegebene MissingMappingAction ab.

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

Syntax

'Declaration
Public Shared Function GetColumnMappingBySchemaAction ( _
    columnMappings As DataColumnMappingCollection, _
    sourceColumn As String, _
    mappingAction As MissingMappingAction _
) As DataColumnMapping
'Usage
Dim columnMappings As DataColumnMappingCollection
Dim sourceColumn As String
Dim mappingAction As MissingMappingAction
Dim returnValue As DataColumnMapping

returnValue = DataColumnMappingCollection.GetColumnMappingBySchemaAction(columnMappings, sourceColumn, mappingAction)

public static DataColumnMapping GetColumnMappingBySchemaAction (
    DataColumnMappingCollection columnMappings,
    string sourceColumn,
    MissingMappingAction mappingAction
)

public:
static DataColumnMapping^ GetColumnMappingBySchemaAction (
    DataColumnMappingCollection^ columnMappings, 
    String^ sourceColumn, 
    MissingMappingAction mappingAction
)

public static DataColumnMapping GetColumnMappingBySchemaAction (
    DataColumnMappingCollection columnMappings, 
    String sourceColumn, 
    MissingMappingAction mappingAction
)

public static function GetColumnMappingBySchemaAction (
    columnMappings : DataColumnMappingCollection, 
    sourceColumn : String, 
    mappingAction : MissingMappingAction
) : DataColumnMapping

Parameter

columnMappings
Die DataColumnMappingCollection.

sourceColumn
Der zu suchende Quellspaltenname unter Berücksichtigung von Groß- und Kleinschreibung.

mappingAction
Einer der MissingMappingAction-Werte.

Rückgabewert

Ein DataColumnMapping-Objekt.

Ausnahmen

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

Hinweise

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

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

MissingMappingAction	Ausgeführte Aktion
Passthrough	Erstellt eine DataColumnMapping, wobei der angegebene Quellspaltenname sowohl als Quellspaltenname als auch als DataSet-Spaltenname verwendet wird. Diese DataColumnMapping wird der Auflistung nicht hinzugefügt.
Error	Eine InvalidOperationException-Ausnahme wird ausgelöst, wenn die angegebene Spaltenzuordnung fehlt.
Ignore	Ruft einen NULL-Wert ab.

Beispiel

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

Public Sub FindDataColumnMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Description") Then
        mapping = _
           DataColumnMappingCollection.GetColumnMappingBySchemaAction _
           (mappings, "Description", MissingMappingAction.Ignore)
    End If
End Sub

public void FindDataColumnMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Description"))
        mapping = DataColumnMappingCollection.GetColumnMappingBySchemaAction
            (mappings, "Description", 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

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

Freigeben über