DataColumnMappingCollection.GetColumnMappingBySchemaAction(DataColumnMappingCollection, String, MissingMappingAction) DataColumnMappingCollection.GetColumnMappingBySchemaAction(DataColumnMappingCollection, String, MissingMappingAction) DataColumnMappingCollection.GetColumnMappingBySchemaAction(DataColumnMappingCollection, String, MissingMappingAction) DataColumnMappingCollection.GetColumnMappingBySchemaAction(DataColumnMappingCollection, String, MissingMappingAction) Method

Definition

Ruft eine DataColumnMapping für die angegebene DataColumnMappingCollection, den angegebenen Quellspaltennamen und die angegebene MissingMappingAction ab.Gets a DataColumnMapping for the specified DataColumnMappingCollection, source column name, and MissingMappingAction.

public:
 static System::Data::Common::DataColumnMapping ^ GetColumnMappingBySchemaAction(System::Data::Common::DataColumnMappingCollection ^ columnMappings, System::String ^ sourceColumn, System::Data::MissingMappingAction mappingAction);
public static System.Data.Common.DataColumnMapping GetColumnMappingBySchemaAction (System.Data.Common.DataColumnMappingCollection columnMappings, string sourceColumn, System.Data.MissingMappingAction mappingAction);
static member GetColumnMappingBySchemaAction : System.Data.Common.DataColumnMappingCollection * string * System.Data.MissingMappingAction -> System.Data.Common.DataColumnMapping
Public Shared Function GetColumnMappingBySchemaAction (columnMappings As DataColumnMappingCollection, sourceColumn As String, mappingAction As MissingMappingAction) As DataColumnMapping

Parameter

sourceColumn
String String String String

Der zu suchende Quellspaltenname unter Berücksichtigung von Groß- und Kleinschreibung.The case-sensitive source column name to find.

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 einem DataColumnMapping -Wert mit dem angegebenen Quell Spaltennamen in der-Auflistung gesucht.The following example searches for a DataColumnMapping with the given source column 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 DataColumnMappingCollection , dass eine DataColumnMapping -Auflistung und ein-Objekt erstellt wurden.The example assumes that a DataColumnMappingCollection collection and a DataColumnMapping object have been created.

public void FindDataColumnMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Description"))
        mapping = DataColumnMappingCollection.GetColumnMappingBySchemaAction
            (mappings, "Description", MissingMappingAction.Ignore);
}
Public Sub FindDataColumnMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Description") Then
        mapping = _
           DataColumnMappingCollection.GetColumnMappingBySchemaAction _
           (mappings, "Description", MissingMappingAction.Ignore)
    End If
End Sub

Hinweise

Wenn der DataColumnMapping in der Auflistung vorhanden ist, wird er zurückgegeben.If the DataColumnMapping exists in the collection, it is returned.

Wenn der DataColumnMapping in der Auflistung nicht vorhanden ist, werden für einen MissingMappingActionangegebenen folgende Aktionen ausgeführt:If the DataColumnMapping does not exist in the collection, for a given MissingMappingAction, the following actions occur:

MissingMappingActionMissingMappingAction Ausgeführte AktionAction Taken
Passthrough Erstellt eine DataColumnMapping mit dem angegebenen Quell Spaltennamen sowohl als Quell Spaltenname als DataSet auch als Spaltennamen.Creates a DataColumnMapping with the specified source column name as both the source column name and the DataSet column name. Diese DataColumnMapping wird der-Auflistung nicht hinzugefügt.This DataColumnMapping is not added to the collection.
Error Eine InvalidOperationException-Ausnahme wird ausgelöst, wenn die angegebene Spaltenzuordnung fehlt.An InvalidOperationException is generated if the specified column mapping is missing.
Ignore Ruft einen NULL-Wert ab.Gets a null value.

Gilt für:

Siehe auch