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

Das folgende Beispiel sucht nach einem DataColumnMapping mit dem angegebenen Quellspaltennamen in der Auflistung.The following example searches for a DataColumnMapping with the given source column name within the collection. Wenn das Objekt vorhanden ist, wird sie zurückgegeben.If the object exists, it is returned. Im Beispiel wird vorausgesetzt, dass eine DataColumnMappingCollection Auflistung und ein DataColumnMapping 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 die DataColumnMapping vorhanden ist in der Auflistung wird zurückgegeben.If the DataColumnMapping exists in the collection, it is returned.

Wenn die DataColumnMapping existiert nicht in der Auflistung für einen angegebenen MissingMappingAction, die folgenden 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 Quellspaltennamen als sowohl der Name der Quellspalte und die DataSet Spaltenname.Creates a DataColumnMapping with the specified source column name as both the source column name and the DataSet column name. Dies DataColumnMapping wird nicht zur Auflistung 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