IColumnMappingCollection インターフェイス
アセンブリ: System.Data (system.data.dll 内)
構文
解説IColumnMappingCollection インターフェイスによって、継承クラスは ColumnMapping コレクションを実装できます。詳細については、「DataTable と DataColumn のマップの設定」を参照してください。
アプリケーションでは IColumnMappingCollection インターフェイスのインスタンスは直接作成されず、IColumnMappingCollection を継承するクラスのインスタンスが作成されます。
IColumnMappingCollection を継承するクラスは、すべての継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、IColumnMappingCollection インターフェイスが RemoveAt メソッドを定義します。次に、DataTableMappingCollection クラスがこのメソッドを継承し、RemoveAt の 2 つの追加オーバーロードを定義します。
実装時の注意 IColumnMappingCollection インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。
使用例派生クラスである DataTableMapping クラスのインスタンスを使用し、Add で複数の DataColumnMapping オブジェクトを ColumnMappings コレクションに追加し、割り当てられたソース テーブルのリストを表示する例を次に示します。この例は、DataTableMapping が既に作成されていることを前提にしています。
Public Sub ShowColumnMappings() ' ... ' create tableMapping ' ... tableMapping.ColumnMappings.Add( _ "Category Name", "DataCategory") tableMapping.ColumnMappings.Add( _ "Description", "DataDescription") tableMapping.ColumnMappings.Add( _ "Picture", "DataPicture") Console.WriteLine("Column Mappings:") Dim i As Integer For i = 0 To tableMapping.ColumnMappings.Count - 1 Console.WriteLine(" {0} {1}", i, _ tableMapping.ColumnMappings(i).ToString()) Next i End Sub
public void ShowColumnMappings() { // ... // create tableMapping // ... tableMapping.ColumnMappings.Add("Category Name","DataCategory"); tableMapping.ColumnMappings.Add("Description","DataDescription"); tableMapping.ColumnMappings.Add("Picture","DataPicture"); Console.WriteLine("Column Mappings"); for(int i=0;i < tableMapping.ColumnMappings.Count;i++) { Console.WriteLine(" {0} {1}", i, tableMapping.ColumnMappings[i].ToString()); } }
プラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照IColumnMappingCollection プロパティ
IColumnMappingCollection メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Add | ソース列名と DataSet 列名を使用して、ColumnMapping オブジェクトを ColumnMapping コレクションに追加します。 |
| Contains | 指定したソース列名を持つ DataColumnMapping オブジェクトが DataColumnMappingCollection に格納されているかどうかを示す値を取得します。 |
| GetByDataSetColumn | 指定した DataSet 列名で ColumnMapping オブジェクトを取得します。 |
| IndexOf | 指定したソース列名で DataColumnMapping オブジェクトの位置を取得します。名前の大文字と小文字は区別されます。 |
| RemoveAt | 指定した SourceColumn 名を持つ IColumnMapping オブジェクトをコレクションから削除します。 |
参照IColumnMappingCollection メンバ
DataColumnMapping オブジェクトのコレクションを格納します。.NET Framework データ プロバイダが共通に使用する DataColumnMappingCollection によって実装されます。
IColumnMappingCollection データ型で公開されるメンバを以下の表に示します。
パブリック プロパティ
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Add | ソース列名と DataSet 列名を使用して、ColumnMapping オブジェクトを ColumnMapping コレクションに追加します。 |
| Contains | 指定したソース列名を持つ DataColumnMapping オブジェクトが DataColumnMappingCollection に格納されているかどうかを示す値を取得します。 |
| GetByDataSetColumn | 指定した DataSet 列名で ColumnMapping オブジェクトを取得します。 |
| IndexOf | 指定したソース列名で DataColumnMapping オブジェクトの位置を取得します。名前の大文字と小文字は区別されます。 |
| RemoveAt | 指定した SourceColumn 名を持つ IColumnMapping オブジェクトをコレクションから削除します。 |
参照- IColumnMappingCollectionのページへのリンク