DataAdapter.TableMappings プロパティとは何？わかりやすく解説 Weblio辞書

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

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

DataAdapter.TableMappings プロパティ

ソーステーブルと DataTable との間のマスターマップを提供するコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 TableMappings As DataTableMappingCollection

Visual Basic (使用法)

Dim instance As DataAdapter
Dim value As DataTableMappingCollection

value = instance.TableMappings

public DataTableMappingCollection TableMappings { get;
 }

C++

public:
property DataTableMappingCollection^ TableMappings {
    DataTableMappingCollection^ get ();
}

/** @property */
public DataTableMappingCollection get_TableMappings ()

JScript

public function get TableMappings
 () : DataTableMappingCollection

プロパティ値
返されたレコードと DataSet との間のマスターマップを提供するコレクション。既定値は空のコレクションです。

解説

DataAdapter は、変更を調整するときに、DataTableMappingCollection コレクションを使用して、データソースで使われる列名と DataSet で使われる列名とを関連付けます。

使用例

OleDbDataAdapter 派生クラスを使用して、DataTableMapping オブジェクトを TableMappings コレクションに追加し、このコレクションで割り当てられたソーステーブルの一覧を表示する例を次に示します。この例では、OleDbDataAdapter が作成されていることを前提にしています。

Visual Basic

Public Sub ShowTableMappings()
    ' ...
    ' create myDataAdapter
    ' ...
    myDataAdapter.TableMappings.Add("Categories",
 "DataCategories")
    myDataAdapter.TableMappings.Add("Orders", "DataOrders")
    myDataAdapter.TableMappings.Add("Products", "DataProducts")
    Dim myMessage As String
 = "Table Mappings:" + ControlChars.Cr
    Dim i As Integer
    For i = 0 To myDataAdapter.TableMappings.Count
 - 1
        myMessage += i.ToString() + " " _
           + myDataAdapter.TableMappings(i).ToString() + ControlChars.Cr
    Next i
    MessageBox.Show(myMessage)
End Sub

public void ShowTableMappings() {
   // ...
   // create myDataAdapter
   // ...
   myDataAdapter.TableMappings.Add("Categories","DataCategories");
   myDataAdapter.TableMappings.Add("Orders","DataOrders");
   myDataAdapter.TableMappings.Add("Products","DataProducts");
   string myMessage = "Table Mappings:\n";
   for(int i=0;i < myDataAdapter.TableMappings.Count;i++)
 {
      myMessage += i.ToString() + " "
         + myDataAdapter.TableMappings[i].ToString() + "\n";
   }
   MessageBox.Show(myMessage);
}