次の方法で共有

DataColumnMappingCollection.GetColumnMappingBySchemaAction メソッド

  • [アーティクル]

指定した DataColumnMappingCollection 、ソース列名、および MissingMappingAction を使用して、 DataColumnMapping を取得します。

Public Shared Function GetColumnMappingBySchemaAction( _
   ByVal columnMappings As DataColumnMappingCollection, _   ByVal sourceColumn As String, _   ByVal mappingAction As MissingMappingAction _) As DataColumnMapping
[C#]
public static DataColumnMapping GetColumnMappingBySchemaAction(DataColumnMappingCollectioncolumnMappings,stringsourceColumn,MissingMappingActionmappingAction);
[C++]
public: static DataColumnMapping* GetColumnMappingBySchemaAction(DataColumnMappingCollection* columnMappings,String* sourceColumn,MissingMappingActionmappingAction);
[JScript]
public static function GetColumnMappingBySchemaAction(
   columnMappings : DataColumnMappingCollection,sourceColumn : String,mappingAction : MissingMappingAction) : DataColumnMapping;

パラメータ

戻り値

DataColumnMapping オブジェクト。

例外

例外の種類 条件
InvalidOperationException mappingAction パラメータが Error に設定され、マップが指定されませんでした。

解説

コレクション内に目的の DataColumnMapping が存在する場合は、そのマップが返されます。

コレクション内に目的の DataColumnMapping が存在しない場合は、指定した MissingMappingAction によって、次のアクションが実行されます。

MissingMappingAction アクション
Passthrough 指定したソース列名をソース列名と DataSet 列名の両方に使用して、 DataColumnMapping を作成します。この DataColumnMapping はコレクションには追加されません。
Error 指定した列マップが存在しない場合、 InvalidOperationException が生成されます。
Ignore null 値を取得します。

使用例

[Visual Basic, C#, C++] コレクション内で、指定したソース列名が含まれる DataColumnMapping を検索する例を次に示します。目的のオブジェクトが存在する場合は、そのオブジェクトを返します。この例では、 DataColumnMappingCollection コレクションと DataColumnMapping オブジェクトが作成されていることを前提にしています。

 
Public Sub FindDataColumnMapping()
    ' ...
    ' create myColumnMappings and myNewMapping
    ' ...
    If myColumnMappings.Contains("Description") Then
        myNewMapping = _
           DataColumnMappingCollection.GetColumnMappingBySchemaAction _
           (myColumnMappings, "Description", MissingMappingAction.Ignore)
    End If
End Sub

[C#] 
public void FindDataColumnMapping() {
   // ...
   // create myColumnMappings and myNewMapping
   // ...
   if (myColumnMappings.Contains("Description"))
      myNewMapping = DataColumnMappingCollection.GetColumnMappingBySchemaAction
         (myColumnMappings, "Description", MissingMappingAction.Ignore);
}

[C++] 
void FindDataColumnMapping() {
   // ...
   // create myColumnMappings and myNewMapping
   // ...
   if (myColumnMappings->Contains(S"Description"))
       myNewMapping = DataColumnMappingCollection::GetColumnMappingBySchemaAction
       (myColumnMappings, S"Description", MissingMappingAction::Ignore);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataColumnMappingCollection クラス | DataColumnMappingCollection メンバ | System.Data.Common 名前空間