DataTableMappingCollection.GetTableMappingBySchemaAction メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataTableMappingCollection.GetTableMappingBySchemaAction メソッド

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetTableMappingBySchemaAction
 ( _
    tableMappings As DataTableMappingCollection, _
    sourceTable As String, _
    dataSetTable As String, _
    mappingAction As MissingMappingAction _
) As DataTableMapping

Visual Basic (使用法)

Dim tableMappings As DataTableMappingCollection
Dim sourceTable As String
Dim dataSetTable As String
Dim mappingAction As MissingMappingAction
Dim returnValue As DataTableMapping

returnValue = DataTableMappingCollection.GetTableMappingBySchemaAction(tableMappings,
 sourceTable, dataSetTable, mappingAction)

public static DataTableMapping GetTableMappingBySchemaAction
 (
    DataTableMappingCollection tableMappings,
    string sourceTable,
    string dataSetTable,
    MissingMappingAction mappingAction
)

C++

public:
static DataTableMapping^ GetTableMappingBySchemaAction (
    DataTableMappingCollection^ tableMappings, 
    String^ sourceTable, 
    String^ dataSetTable, 
    MissingMappingAction mappingAction
)

public static DataTableMapping GetTableMappingBySchemaAction
 (
    DataTableMappingCollection tableMappings, 
    String sourceTable, 
    String dataSetTable, 
    MissingMappingAction mappingAction
)

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 パラメータは無視されます。

使用例

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

Visual Basic

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

public void FindDataTableMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Categories")) 
    {
        mapping = DataTableMappingCollection.GetTableMappingBySchemaAction
            (mappings, "Categories", "", MissingMappingAction.Ignore);
    }
}