IColumnMappingCollection 介面

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

組件:

System.Data.dll

組件:

netstandard.dll

含有 DataColumnMapping 物件的集合，並且是由 .NET 資料提供者共同使用的 DataColumnMappingCollection 所實作。

public interface class IColumnMappingCollection : System::Collections::IList

public interface IColumnMappingCollection : System.Collections.IList

type IColumnMappingCollection = interface
    interface ICollection
    interface IEnumerable
    interface IList

type IColumnMappingCollection = interface
    interface IList
    interface ICollection
    interface IEnumerable

Public Interface IColumnMappingCollection
Implements IList

衍生

System.Data.Common.DataColumnMappingCollection

實作

ICollection IEnumerable IList

範例

下列範例會使用衍生類別 DataTableMapping 的實例，將其 Add 集合中的 ColumnMappings 數 DataColumnMapping 個物件，然後顯示這些對應的來源資料表清單。 此範例假設 DataTableMapping 已經建立 。

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());
    }
}

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

備註

介面 IColumnMappingCollection 可讓繼承類別實作 ColumnMapping 集合。 如需詳細資訊，請參閱 DataAdapter DataTable 和 DataColumn 對應。

應用程式不會直接建立介面的 IColumnMappingCollection 實例，但會建立繼承 IColumnMappingCollection 之類別的實例。

繼承 IColumnMappingCollection 的類別必須實作所有繼承的成員，而且通常會定義其他成員以新增提供者特定的功能。 例如， IColumnMappingCollection 介面會 RemoveAt 定義 方法。 接著，類別 DataTableMappingCollection 會繼承這個方法，並定義 的兩個額外多載 RemoveAt 。

給實施者的注意事項

當您繼承自 介面時，應該實作 IColumnMappingCollection 下列建構函式：

項目	描述
ColumnMappingCollection ()	建立空的 ColumnMappingCollection 類別。

屬性

Count	取得 ICollection 中所包含的項目數。 (繼承來源 ICollection)
IsFixedSize	取得值，指出 IList 是否有固定的大小。 (繼承來源 IList)
IsReadOnly	取得值，指出 IList 是否唯讀。 (繼承來源 IList)
IsSynchronized	取得值，這個值表示對 ICollection 的存取是否同步 (安全執行緒)。 (繼承來源 ICollection)
Item[Int32]	在指定的索引位置上取得或設定項目。 (繼承來源 IList)
Item[String]	取得或設定具有指定 SourceColumn 名稱的 IColumnMapping 物件。
SyncRoot	取得可用以同步存取 ICollection 的物件。 (繼承來源 ICollection)

方法

Add(Object)	將項目加入至 IList。 (繼承來源 IList)
Add(String, String)	使用來源資料行和 DataSet 資料行名稱來將 ColumnMapping 物件加入至 ColumnMapping 集合。
Clear()	從 IList 中移除所有項目。 (繼承來源 IList)
Contains(Object)	判斷 IList 是否包含特定值。 (繼承來源 IList)
Contains(String)	取得值，表示 DataColumnMappingCollection 是否包含具有指定來源資料行名稱的 DataColumnMapping 物件。
CopyTo(Array, Int32)	從特定的 ICollection 索引開始，將 Array 的項目複製到 Array。 (繼承來源 ICollection)
GetByDataSetColumn(String)	取得具有指定 DataSet 資料行名稱的 ColumnMapping 物件。
GetEnumerator()	傳回逐一查看集合的列舉值。 (繼承來源 IEnumerable)
IndexOf(Object)	判斷 IList 中指定項目的索引。 (繼承來源 IList)
IndexOf(String)	取得具有指定來源資料行名稱的 DataColumnMapping 物件位置。 名稱區分大小寫。
Insert(Int32, Object)	將項目插入位於指定索引的 IList。 (繼承來源 IList)
Remove(Object)	從 IList 移除特定物件之第一個符合的元素。 (繼承來源 IList)
RemoveAt(Int32)	移除在指定索引處的 IList 項目。 (繼承來源 IList)
RemoveAt(String)	從集合中移除具有指定 IColumnMapping 名稱的 SourceColumn 物件。

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。