DataTableMappingCollection.GetTableMappingBySchemaAction メソッド

MissingMappingAction を使用して、指定したソース テーブル名および DataSet テーブル名が含まれる DataColumnMapping オブジェクトを取得します。

Public Shared Function GetTableMappingBySchemaAction( _
   ByVal tableMappings As DataTableMappingCollection, _   ByVal sourceTable As String, _   ByVal dataSetTable As String, _   ByVal mappingAction As MissingMappingAction _) As DataTableMapping
[C#]
public static DataTableMapping GetTableMappingBySchemaAction(DataTableMappingCollectiontableMappings,stringsourceTable,stringdataSetTable,MissingMappingActionmappingAction);
[C++]
public: static DataTableMapping* GetTableMappingBySchemaAction(DataTableMappingCollection* tableMappings,String* sourceTable,String* dataSetTable,MissingMappingActionmappingAction);
[JScript]
public static function GetTableMappingBySchemaAction(
   tableMappings : DataTableMappingCollection,sourceTable : String,dataSetTable : String,mappingAction : MissingMappingAction) : DataTableMapping;

パラメータ

• tableMappings
  検索する DataTableMappingCollection コレクション。
• sourceTable
  割り当てられたソース テーブル名。大文字と小文字が区別されます。
• dataSetTable
  割り当てられた DataSet テーブル名。大文字と小文字は区別されません。
• mappingAction
  MissingMappingAction 値の 1 つ。

戻り値

DataTableMapping オブジェクト。

例外

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

解説

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

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

MissingMappingAction	アクション
Passthrough	指定した sourceTable をソース テーブル名に、 dataSetTable を DataSet テーブル名に使用して、 DataTableMapping オブジェクトを作成します。作成された DataTableMapping オブジェクトはコレクションには追加されません。
Error	例外を生成します。 dataSetTable パラメータは無視されます。
Ignore	null 参照 (Visual Basic では Nothing) 値を取得します。 dataSetTable パラメータは無視されます。

使用例

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

 
Public Sub FindDataTableMapping()
    ' ...
    ' create myTableMappings and myNewMapping
    ' ...
    If myTableMappings.Contains("Categories") Then
        myNewMapping = _
           DataTableMappingCollection.GetTableMappingBySchemaAction _
           (myTableMappings, "Categories", "", MissingMappingAction.Ignore)
    End If
End Sub

[C#] 
public void FindDataTableMapping() {
   // ...
   // create myTableMappings and myNewMapping
   // ...
   if (myTableMappings.Contains("Categories")) {
      myNewMapping = DataTableMappingCollection.GetTableMappingBySchemaAction
         (myTableMappings, "Categories", "", MissingMappingAction.Ignore);
   }
}

[C++] 
void FindDataTableMapping() {
   // ...
   // create myTableMappings and myNewMapping
   // ...
   if (myTableMappings->Contains(S"Categories")) {
       myNewMapping = DataTableMappingCollection::GetTableMappingBySchemaAction
          (myTableMappings, S"Categories", S"", 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

参照

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