IColumnMappingCollection Interface


包含一个 DataColumnMapping 对象的集合,并由 DataColumnMappingCollection 实现,这是由 .NET Framework 数据提供程序通常使用的方法。Contains a collection of DataColumnMapping objects, and is implemented by the DataColumnMappingCollection, which is used in common by .NET Framework data providers.

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


下面的示例使用派生类的实例 DataTableMapping将多个 DataColumnMapping 对象 Add 到其 ColumnMappings 集合,然后显示这些映射的源表的列表。The following example uses an instance of the derived class, DataTableMapping, to Add several DataColumnMapping objects to its ColumnMappings collection, and then displays a list of those mapped source tables. 此示例假设已创建 DataTableMappingThis example assumes that a DataTableMapping has already been created.

public void ShowColumnMappings()
    // ...
    // create tableMapping
    // ...
    tableMapping.ColumnMappings.Add("Category Name","DataCategory");
    Console.WriteLine("Column Mappings");
    for(int i=0;i < tableMapping.ColumnMappings.Count;i++)
        Console.WriteLine("  {0} {1}", i,
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, _
    Next i
End Sub


IColumnMappingCollection 接口允许继承类实现 ColumnMapping 集合。The IColumnMappingCollection interface enables an inheriting class to implement a ColumnMapping collection. 有关详细信息,请参阅DataAdapter DataTable And DataColumn 映射For more information, see DataAdapter DataTable and DataColumn Mappings.

应用程序不会直接创建 IColumnMappingCollection 接口的实例,而是创建继承 IColumnMappingCollection的类的实例。An application does not create an instance of the IColumnMappingCollection interface directly, but creates an instance of a class that inherits IColumnMappingCollection.

继承 IColumnMappingCollection 的类必须实现所有继承成员,并且通常定义其他成员来添加特定于提供程序的功能。Classes that inherit IColumnMappingCollection must implement all inherited members, and typically define additional members to add provider-specific functionality. 例如,IColumnMappingCollection 接口定义 RemoveAt 方法。For example, the IColumnMappingCollection interface defines the RemoveAt method. 反过来,DataTableMappingCollection 类继承了此方法,并定义了 RemoveAt的两个附加重载。In turn, the DataTableMappingCollection class inherits this method, and defines two additional overloads of RemoveAt.

Notes to Implementers

当从 IColumnMappingCollection 接口继承时,应实现以下构造函数:When you inherit from the IColumnMappingCollection interface, you should implement the following constructor:

Item 说明Description
采用()ColumnMappingCollection() 创建一个空的采用类。Creates an empty ColumnMappingCollection class.



获取 ICollection 中包含的元素数。Gets the number of elements contained in the ICollection.

(Inherited from ICollection)

获取一个值,该值指示 IList 是否具有固定大小。Gets a value indicating whether the IList has a fixed size.

(Inherited from IList)

获取一个值,用于指示 IList 是否为只读。Gets a value indicating whether the IList is read-only.

(Inherited from IList)

获取一个值,该值指示是否同步对 ICollection 的访问(线程安全)。Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Inherited from ICollection)

获取或设置指定索引处的元素。Gets or sets the element at the specified index.

(Inherited from IList)

获取或设置具有指定 SourceColumn 名称的 IColumnMapping 对象。Gets or sets the IColumnMapping object with the specified SourceColumn name.


获取可用于同步对 ICollection 的访问的对象。Gets an object that can be used to synchronize access to the ICollection.

(Inherited from ICollection)



将项添加到 IList 中。Adds an item to the IList.

(Inherited from IList)
Add(String, String)

使用源列和 DataSet 列名,将 ColumnMapping 对象添加到 ColumnMapping 集合中。Adds a ColumnMapping object to the ColumnMapping collection using the source column and DataSet column names.


IList 中移除所有项。Removes all items from the IList.

(Inherited from IList)

确定 IList 是否包含特定值。Determines whether the IList contains a specific value.

(Inherited from IList)

获取一个值,该值指示 DataColumnMappingCollection 是否包含具有指定源列名称的 DataColumnMapping 对象。Gets a value indicating whether the DataColumnMappingCollection contains a DataColumnMapping object with the specified source column name.

CopyTo(Array, Int32)

从特定的 ICollection 索引开始,将 Array 的元素复制到一个 Array 中。Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Inherited from ICollection)

获取具有指定 DataSet 列名的 ColumnMapping 对象。Gets the ColumnMapping object with the specified DataSet column name.


返回循环访问集合的枚举器。Returns an enumerator that iterates through a collection.

(Inherited from IEnumerable)

确定 IList 中特定项的索引。Determines the index of a specific item in the IList.

(Inherited from IList)

获取具有指定源列名称的 DataColumnMapping 对象的位置。Gets the location of the DataColumnMapping object with the specified source column name. 该名称区分大小写。The name is case-sensitive.

Insert(Int32, Object)

将项插入到 IList 中的指定索引处。Inserts an item to the IList at the specified index.

(Inherited from IList)

IList 中删除特定对象的第一个匹配项。Removes the first occurrence of a specific object from the IList.

(Inherited from IList)

移除位于指定索引处的 IList 项。Removes the IList item at the specified index.

(Inherited from IList)

从集合中移除具有指定 SourceColumn 名称的 IColumnMapping 对象。Removes the IColumnMapping object with the specified SourceColumn name from the collection.

Extension Methods


IEnumerable 的元素强制转换为指定的类型。Casts the elements of an IEnumerable to the specified type.


根据指定类型筛选 IEnumerable 的元素。Filters the elements of an IEnumerable based on a specified type.


启用查询的并行化。Enables parallelization of a query.


IEnumerable 转换为 IQueryableConverts an IEnumerable to an IQueryable.

Applies to