DataColumnMappingCollection.GetColumnMappingBySchemaAction メソッド

定義

指定したDataColumnMapping、ソース列名、およびDataColumnMappingCollectionMissingMappingActionを取得します。

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);
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

パラメーター

sourceColumn
String

検索するソース列名の大文字と小文字が区別されます。

mappingAction
MissingMappingAction

MissingMappingAction値の 1 つ。

返品

DataColumnMapping オブジェクト。

例外

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 値を取得します。

適用対象

こちらもご覧ください