IColumnMapping インターフェイス

データ ソース列に DataSet 列を関連付けます。この関連付けは、.NET Framework データ プロバイダが共通に使用する DataColumnMapping クラスによって実装されます。

この型のすべてのメンバの一覧については、IColumnMapping メンバ を参照してください。

Public Interface IColumnMapping
[C#]
public interface IColumnMapping
[C++]
public __gc __interface IColumnMapping
[JScript]
public interface IColumnMapping

IColumnMapping を実装するクラス

クラス 説明
DataColumnMapping DataAdapter から継承されるオブジェクトの汎用的な列マップを格納します。このクラスは継承できません。

解説

IColumnMapping インターフェイスによって、継承クラスは、データ ソース列に DataSet 列を関連付ける ColumnMapping クラスを実装できます。詳細については、「 DataTable と DataColumn のマップの設定 」を参照してください。

アプリケーションでは IColumnMapping インターフェイスのインスタンスは直接作成されず、 IColumnMapping を継承するクラスのインスタンスが作成されます。

IColumnMapping を継承するクラスは、すべての継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、 IColumnMapping インターフェイスが DataSetColumn プロパティを定義します。次に、 DataColumnMapping クラスがこのプロパティを継承し、 GetDataColumnBySchemaAction メソッドを定義します。

実装時の注意: IColumnMapping インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。

項目 説明
ColumnMapping() ColumnMapping クラスの新しいインスタンスを初期化します。
ColumnMapping(string sourceColumn, string dataSetColumn) 指定したソース列名と DataSet 列名を持つソースを使用して、ColumnMapping クラスの新しいインスタンスを初期化します。

使用例

[Visual Basic, C#, C++] 派生クラスのインスタンス DataColumnMapping を作成し、 DataColumnMappingCollection コレクションに追加する例を次に示します。この例では、続いて、マップがコレクションに追加されたことをユーザーに通知し、マップの親を表示します。

 
Public Sub AddDataColumnMapping()
    ' ...
    ' create myColumnMappings
    ' ...
    Dim myNewMapping As New DataColumnMapping("Description", "DataDescription")
    myColumnMappings.Add(CType(myNewMapping, Object))
    MessageBox.Show("column " + myNewMapping.ToString() + " added to " _
       + "column mapping collection " + myColumnMappings.ToString())
End Sub

[C#] 

 public void AddDataColumnMapping() {
    // ...
    // create myColumnMappings
    // ...
    DataColumnMapping myNewMapping =
       new DataColumnMapping("Description","DataDescription");
    myColumnMappings.Add((Object) myNewMapping);
    MessageBox.Show("column " + myNewMapping.ToString() + " added to " +
       "column mapping collection " + myColumnMappings.ToString());
 }

[C++] 
void AddDataColumnMapping() {
   // ...
   // create myColumnMappings
   // ...
   DataColumnMapping* myNewMapping =
      new DataColumnMapping(S"Description",S"DataDescription");
   myColumnMappings->Add(static_cast<Object*>(myNewMapping));
   MessageBox::Show(String::Concat( S"column ", myNewMapping->ToString(), S" added to ",
      S"column mapping collection ", myColumnMappings->ToString() ));
}

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

必要条件

名前空間: System.Data

プラットフォーム: 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

アセンブリ: System.Data (System.Data.dll 内)

参照

IColumnMapping メンバ | System.Data 名前空間