DataColumnCollection 類別

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

來源:

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可以包含的數據種類。 您可以透過 Columns 物件的屬性DataTable來存取 DataColumnCollection 。

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