DataColumnMappingCollection.GetColumnMappingBySchemaAction 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DataColumnMappingCollection.cs

為指定 DataColumnMapping、來源資料行名稱和 DataColumnMappingCollection 取得 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

參數

columnMappings

DataColumnMappingCollection

DataColumnMappingCollection。

sourceColumn

String

要尋找的區分大小寫來源資料行名稱。

mappingAction

MissingMappingAction

其中一個 MissingMappingAction 值。

傳回

DataColumnMapping

DataColumnMapping 物件。

例外狀況

InvalidOperationException

mappingAction 參數已經設定為 Error，並且未指定任何對應。

範例

下列範例會在集合中搜尋 DataColumnMapping 具有指定來源資料列名稱的 。 如果物件存在，則會傳回它。 此範例假設 DataColumnMappingCollection 已建立集合和 DataColumnMapping 物件。

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

備註

DataColumnMapping如果 存在於集合中，則會傳回它。

DataColumnMapping如果集合中不存在 ，則針對指定的 MissingMappingAction，會發生下列動作：

MissingMappingAction	已採取動作
Passthrough	使用指定的源數據行名稱建立 ， DataColumnMapping 做為源數據行名稱和 DataSet 數據行名稱。 這 DataColumnMapping 不會新增至集合。
Error	如果缺少指定的資料行對應，則會產生 InvalidOperationException。
Ignore	取得 Null 值。

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)