IColumnMapping 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將資料來源欄位與欄位 DataSet 關聯,並由 DataColumnMapping 類別實作,該類別在 .NET 資料提供者中普遍使用。
public interface class IColumnMapping
public interface IColumnMapping
type IColumnMapping = interface
Public Interface IColumnMapping
- 衍生
範例
以下範例建立導出類別 DataColumnMapping的實例,並將其加入集合 DataColumnMappingCollection 中。 接著它會告訴使用者該映射已被加入集合,並顯示映射的父映射。
public void AddDataColumnMapping() {
// ...
// create columnMappings
// ...
DataColumnMapping mapping =
new DataColumnMapping("Description","DataDescription");
columnMappings.Add((Object) mapping);
Console.WriteLine("Column {0} added to column mapping collection {1}.",
mapping.ToString(), columnMappings.ToString());
}
Public Sub AddDataColumnMapping()
' ...
' create columnMappings
' ...
Dim mapping As New DataColumnMapping( _
"Description", "DataDescription")
columnMappings.Add(CType(mapping, Object))
Console.WriteLine("Column {0} added to column mapping collection {1}.", _
mapping.ToString(), columnMappings.ToString())
End Sub
備註
此 IColumnMapping 介面允許繼承類別實作欄位映射類別,將資料來源欄位與欄位 DataSet 關聯。 欲了解更多資訊,請參閱 DataAdapter DataTable 與 DataColumn 映射。
應用程式不會直接建立介面的實例 IColumnMapping ,而是建立一個繼承 的 IColumnMapping類別實例。
繼承 IColumnMapping 類別必須實作所有繼承成員,並通常定義額外成員以增加提供者專屬功能。 例如,介面 IColumnMapping 定義了屬性 DataSetColumn 。 反過來,類別 DataColumnMapping 繼承此特性,並定義 GetDataColumnBySchemaAction 該方法。
給實施者的注意事項
當你從 IColumnMapping 介面繼承時,應該實作以下構造子:
| 項目 | 描述 |
|---|---|
| 欄位映射(ColumnMapping) | 初始化 ColumnMapping 類別的新實例。 |
| ColumnMapping(string sourceColumn, string dataSetColumn) | 初始化一個新的 ColumnMapping 類別實例,並以指定的來源欄位名稱與 DataSet 欄位名稱初始化。 |
屬性
| 名稱 | Description |
|---|---|
| DataSetColumn |
取得或設定 to 映射到的 DataSet 欄位名稱。 |
| SourceColumn |
取得或設定資料來源中要映射的欄位名稱。 名稱會區分大小寫。 |