DataControlFieldCollection 類別

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

表示由 GridView 和 DetailsView 等資料繫結控制項所使用的 DataControlField 物件集合。

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection

public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection

type DataControlFieldCollection = class
    inherit StateManagedCollection

Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection

繼承

Object

StateManagedCollection

DataControlFieldCollection

備註

類別 DataControlFieldCollection 代表資料繫結控制項用來指定其子控制項呈現方式的物件 DataControlField 集合。 類別 DataControlFieldCollection 衍生自 StateManagedCollection ，這是專門用來儲存 IStateManager 物件的抽象基底集合類別。

StateManagedCollection物件會影響 物件的行為 DataControlFieldCollection 。 DataControlField 當狀態還原時，會重新新增至集合中動態加入至 控制項的物件。 這表示欄位必須新增、移除或變更一次，而不是在每個回傳上，因為 ASP.NET 中大部分的集合類型都需要。

(類別會 DataControlField 實作 IStateManager 介面，讓它將其狀態儲存在檢視狀態 ASP.NET。 )

使用 類別 DataControlFieldCollection 以程式設計方式管理一組 DataControlField 物件。 請注意，以宣告方式定義這些欄位比較常見。

您可以使用 類別的適當方法 DataControlFieldCollection 來新增、插入和移除 DataControlField 物件。 若要以程式設計方式從集合擷取 DataControlField 物件，請使用下列其中一種方法：

• 使用索引子，使用陣列標記法從集合中取得單 DataControlField 一物件。

• GetEnumerator使用 方法來建立 System.Collections.IEnumerator 實作的物件，然後可用來從集合取得專案。

屬性 Count 會指定集合中的專案總數，而且通常用來判斷集合的上限。 您可以使用 、 Insert 、 Remove 和 RemoveAt 方法，在集合 Add 中加入和移除專案。

如果您使用 GridView 或 控制項， DataControlField 則 (自動建立的物件，例如，當 AutoGenerateColumns 屬性 true) 未儲存在可公開存取的欄位 DetailsView 集合中時。 您只能存取及操作 DataControlField 未自動產生的物件。

下表列出不同的資料控制欄位類別及其使用方式。

Parameter 類別	描述
DataControlField	所有欄位的抽象基類。
BoundField	資料繫結控制項欄位，用來系結至從 ASP.NET 資料來源控制項擷取的文字或資料。
ButtonFieldBase	資料繫結控制項欄位，可封裝一般按鈕功能。 ButtonField 和 CheckBoxField 衍生自它。
ButtonField	顯示至少一個按鈕的資料繫結控制項欄位。
CheckBoxField	顯示 CheckBox 控制項的資料繫結控制項欄位。
CommandField	資料繫結控制項欄位，顯示可在資料列 (或資料行) 所顯示的資料上執行的動作，例如編輯、更新或刪除。
HyperLinkField	顯示 HyperLink 控制項的資料繫結控制項欄位。
ImageField	顯示 Image 控制項的資料繫結控制項欄位。
TemplateField	資料繫結控制項欄位，顯示資料繫結控制項中的自訂內容。

建構函式

DataControlFieldCollection()

初始化 DataControlFieldCollection 類別的新執行個體。

屬性

Count	取得 StateManagedCollection 集合中所包含的項目數。 (繼承來源 StateManagedCollection)
Item[Int32]	取得或設定位於集合中所指定索引處的 DataControlField 物件。

方法

Add(DataControlField)	將指定的 DataControlField 物件附加到集合的結尾。
Clear()	將所有項目從 StateManagedCollection 集合中移除。 (繼承來源 StateManagedCollection)
CloneFields()	建立目前集合的複本。
Contains(DataControlField)	判斷 DataControlFieldCollection 集合是否含有特定 DataControlField 物件。
CopyTo(Array, Int32)	從特定的陣列索引開始，將 StateManagedCollection 集合的項目複製到陣列。 (繼承來源 StateManagedCollection)
CopyTo(DataControlField[], Int32)	從目標陣列的指定之索引開始，將整個 DataControlFieldCollection 集合複製到相容的一維 Array。
CreateKnownType(Int32)	在衍生類別中覆寫時，建立實作 IStateManager 之類別的執行個體。 根據 GetKnownTypes() 方法所傳回之集合指定的成員，建立物件的類型。 (繼承來源 StateManagedCollection)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回逐一查看 StateManagedCollection 集合的列舉值。 (繼承來源 StateManagedCollection)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetKnownTypes()	在衍生類別中覆寫時，取得 StateManagedCollection 集合可以包含之 IStateManager 類型的陣列。 (繼承來源 StateManagedCollection)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(DataControlField)	判斷集合中特定 DataControlField 物件的索引。
Insert(Int32, DataControlField)	將指定的 DataControlField 物件插入 DataControlFieldCollection 集合中的指定索引處。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnClear()	在衍生類別中覆寫時，在 Clear() 方法移除集合的所有項目之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnClearComplete()	在衍生類別中覆寫時，在 Clear() 方法完成移除集合的所有項目之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnInsert(Int32, Object)	在衍生類別中覆寫時，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法將項目加入集合之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnInsertComplete(Int32, Object)	在衍生類別中覆寫時，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法將項目加入集合之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnRemove(Int32, Object)	在衍生類別中覆寫時，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法從集合中移除指定的項目之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnRemoveComplete(Int32, Object)	在衍生類別中覆寫時，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法從集合中移除指定的項目之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnValidate(Object)	在衍生類別中覆寫時，驗證 StateManagedCollection 集合的項目。 (繼承來源 StateManagedCollection)
Remove(DataControlField)	從 DataControlField 集合中移除指定的 DataControlFieldCollection 物件。
RemoveAt(Int32)	從 DataControlField 集合中移除指定索引處的 DataControlFieldCollection 物件。
SetDirty()	強制整個 StateManagedCollection 集合序列化至檢視狀態。 (繼承來源 StateManagedCollection)
SetDirtyObject(Object)	在衍生類別中覆寫時，指示集合中所包含的 object，將其完整狀態 (而不只是變更資訊) 記錄至檢視狀態。 (繼承來源 StateManagedCollection)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

FieldsChanged

當集合中的欄位變更時發生，通常做為 Clear()、Insert(Int32, DataControlField)、Remove(DataControlField) 或 Add(DataControlField) 方法呼叫的結果。 只要集合中的 DataControlField 引發其 FieldChanged 事件，也會引發這個事件。

明確介面實作

ICollection.Count	取得 StateManagedCollection 集合中所包含的項目數。 (繼承來源 StateManagedCollection)
ICollection.IsSynchronized	取得值，表示 StateManagedCollection 集合是否為同步 (安全執行緒)。 在所有情況下，這個方法都會傳回 false。 (繼承來源 StateManagedCollection)
ICollection.SyncRoot	取得物件，可用來同步處理對 StateManagedCollection 集合的存取。 在所有情況下，這個方法都會傳回 null。 (繼承來源 StateManagedCollection)
IEnumerable.GetEnumerator()	傳回逐一查看 StateManagedCollection 集合的列舉值。 (繼承來源 StateManagedCollection)
IList.Add(Object)	將項目加入 StateManagedCollection 集合。 (繼承來源 StateManagedCollection)
IList.Clear()	將所有項目從 StateManagedCollection 集合中移除。 (繼承來源 StateManagedCollection)
IList.Contains(Object)	判斷 StateManagedCollection 集合是否包含特定值。 (繼承來源 StateManagedCollection)
IList.IndexOf(Object)	判斷 StateManagedCollection 集合中指定之項目的索引。 (繼承來源 StateManagedCollection)
IList.Insert(Int32, Object)	將項目插入位於指定索引處的 StateManagedCollection 集合中。 (繼承來源 StateManagedCollection)
IList.IsFixedSize	取得值，表示 StateManagedCollection 集合是否具有固定大小。 在所有情況下，這個方法都會傳回 false。 (繼承來源 StateManagedCollection)
IList.IsReadOnly	取得值，表示 StateManagedCollection 集合是否為唯讀。 (繼承來源 StateManagedCollection)
IList.Item[Int32]	取得指定索引處的 IStateManager 項目。 (繼承來源 StateManagedCollection)
IList.Remove(Object)	從 StateManagedCollection 集合中移除指定物件的第一個符合項目。 (繼承來源 StateManagedCollection)
IList.RemoveAt(Int32)	移除指定索引處的 IStateManager 項目。 (繼承來源 StateManagedCollection)
IStateManager.IsTrackingViewState	取得值，表示 StateManagedCollection 集合是否正在儲存變更至檢視狀態。 (繼承來源 StateManagedCollection)
IStateManager.LoadViewState(Object)	還原先前儲存之 StateManagedCollection 集合和內含 IStateManager 項目的檢視狀態。 (繼承來源 StateManagedCollection)
IStateManager.SaveViewState()	儲存自頁面回傳至伺服器以來 StateManagedCollection 集合和每個內含 IStateManager 物件的變更。 (繼承來源 StateManagedCollection)
IStateManager.TrackViewState()	使得 StateManagedCollection 集合和每個內含 IStateManager 物件追蹤其檢視狀態的變更，以便跨相同頁面要求保存這些變更。 (繼承來源 StateManagedCollection)

擴充方法

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

另請參閱

• DataControlField
• GridView
• DetailsView