DataColumnMappingCollection.GetColumnMappingBySchemaAction メソッド

定義

指定した 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);
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 値を取得します。

適用対象

こちらもご覧ください