DataColumnCollection 类

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

DataColumnCollection.cs

表示 DataColumn 的 DataTable 对象的集合。

public ref class DataColumnCollection sealed : System::Data::InternalDataCollectionBase

public sealed class DataColumnCollection : System.Data.InternalDataCollectionBase

type DataColumnCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataColumnCollection
Inherits InternalDataCollectionBase

继承

Object

InternalDataCollectionBase

DataColumnCollection

示例

以下示例循环访问 对象的集合 DataColumn ，并打印集合中每个列的各种属性。

private void PrintDataTableColumnInfo(DataTable table)
{
    // Use a DataTable object's DataColumnCollection.
    DataColumnCollection columns = table.Columns;

    // Print the ColumnName and DataType for each column.
    foreach(DataColumn column in columns)
    {
        Console.WriteLine(column.ColumnName);
        Console.WriteLine(column.DataType);
    }
}

Private Sub PrintDataTableColumnInfo(table As DataTable)
    
    ' Use a DataTable object's DataColumnCollection.
    Dim columns As DataColumnCollection = table.Columns

    ' Print the ColumnName and DataType for each column.
    Dim column As DataColumn
    For Each column in columns
       Console.WriteLine(column.ColumnName)
       Console.WriteLine(column.DataType.ToString)
    Next
End Sub

注解

DataColumnCollection定义 的DataTable架构，并确定每个DataColumn可以包含的数据类型。 可以通过 对象的 属性DataTable访问 DataColumnCollectionColumns 。

DataColumnCollection使用 Add 和 Remove 方法来插入和删除 DataColumn 对象。 Count使用 属性确定集合中的对象数DataColumn。 Contains使用 方法验证集合中是否存在指定的索引或列名。

属性

Count	获取集合中的元素总数。 (继承自 InternalDataCollectionBase)
IsReadOnly	获取一个值，该值指示 InternalDataCollectionBase 是否为只读。 (继承自 InternalDataCollectionBase)
IsSynchronized	获取一个值，该值指示 InternalDataCollectionBase 是否已同步。 (继承自 InternalDataCollectionBase)
Item[Int32]	从集合中获取位于指定索引位置的 DataColumn。
Item[String]	从具有指定名称的集合中获取 DataColumn。
List	获取作为列表的集合的项。 (继承自 InternalDataCollectionBase)
SyncRoot	获取可用于同步集合的对象。 (继承自 InternalDataCollectionBase)

方法

Add()	创建 DataColumn 对象并将其添加到 DataColumnCollection 中。
Add(DataColumn)	创建指定的 DataColumn 对象并将其添加到 DataColumnCollection。
Add(String)	创建一个具有指定名称的 DataColumn 对象，并将其添加到 DataColumnCollection 中。
Add(String, Type)	创建一个具有指定名称和类型的 DataColumn 对象，并将其添加到 DataColumnCollection 中。
Add(String, Type, String)	创建一个具有指定名称、类型和表达式的 DataColumn 对象，并将其添加到 DataColumnCollection 中。
AddRange(DataColumn[])	将指定的 DataColumn 数组的元素复制到集合末尾。
CanRemove(DataColumn)	检查是否可从集合中移除特定列。
Clear()	清除集合中的所有列。
Contains(String)	检查集合是否包含具有指定名称的列。
CopyTo(Array, Int32)	将当前 InternalDataCollectionBase 的所有元素复制到一维 Array，从指定的 InternalDataCollectionBase 索引开始。 (继承自 InternalDataCollectionBase)
CopyTo(DataColumn[], Int32)	将整个集合复制到现有数组中，从该数组内的指定索引处开始复制。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	获取集合的 IEnumerator。 (继承自 InternalDataCollectionBase)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(DataColumn)	获取按名称指定的列的索引。
IndexOf(String)	获取具有特定名称的列的索引（名称不区分大小写）。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(DataColumn)	从集合中移除指定的 DataColumn 对象。
Remove(String)	从集合中移除具有指定名称的 DataColumn 对象。
RemoveAt(Int32)	从集合中移除指定索引位置的列。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

CollectionChanged

在由于添加或删除列而使列集合发生变化时发生。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

线程安全性

此类型对于多线程读取操作是安全的。 必须同步所有写入操作。

另请参阅

• Columns
• DataColumn
• DataTable
• DataRelation
• DataRow
• DataSet