DataColumnMappingCollection.GetColumnMappingBySchemaAction-Methode
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 |
---|---|
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