DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection Class

定義

GridViewDetailsView などのデータ バインド コントロールで使用される DataControlField オブジェクトのコレクションを表します。Represents a collection of DataControlField objects that are used by data-bound controls such as GridView and DetailsView.

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
継承
DataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollection

注釈

クラスDataControlFieldCollectionは、子コントロールのDataControlField表示方法を指定するためにデータバインドコントロールによって使用されるオブジェクトのコレクションを表します。The DataControlFieldCollection class represents a collection of DataControlField objects used by data-bound controls to specify how their child controls are presented. クラスDataControlFieldCollectionは、オブジェクトStateManagedCollectionを格納IStateManagerするために特に使用される抽象基本コレクションクラスであるから派生します。The DataControlFieldCollection class derives from StateManagedCollection, an abstract base collection class used specifically to store IStateManager objects.

オブジェクトStateManagedCollectionは、 DataControlFieldCollectionオブジェクトの動作に影響します。A StateManagedCollection object influences the behavior of a DataControlFieldCollection object. DataControlField状態が復元されると、コレクションに動的に追加されるオブジェクトがコントロールに再度追加されます。DataControlField objects that are dynamically added to the collection will be re-added to the control when state is restored. これは、ASP.NET のほとんどのコレクション型で必要になるため、各ポストバックではなく1回だけフィールドを追加、削除、または変更する必要があることを意味します。This means that a field needs to be added, removed, or changed just once instead of on each postback, as most collection types in ASP.NET require.

(クラスDataControlFieldIStateManagerインターフェイスを実装します。これにより、その状態を ASP.NET ビューステートに格納できるようになります。(The DataControlField class implements the IStateManager interface, which enables it to store its state in ASP.NET view state. ))

オブジェクトのDataControlFieldCollection DataControlFieldセットをプログラムで管理するには、クラスを使用します。Use the DataControlFieldCollection class to programmatically manage a set of DataControlField objects. これらのフィールドは、宣言によって定義する方が一般的です。Note that it is more common to define these fields declaratively.

クラスの適切なメソッドを使用しDataControlFieldて、オブジェクトの追加、挿入、および削除を行うことができます。 DataControlFieldCollectionYou can add, insert, and remove DataControlField objects using the appropriate methods of the DataControlFieldCollection class. プログラムによっDataControlFieldてコレクションからオブジェクトを取得するには、次のいずれかの方法を使用します。To programmatically retrieve DataControlField objects from a collection, use one of following methods:

  • インデクサーを使用して、配列DataControlField表記を使用してコレクションから1つのオブジェクトを取得します。Use the indexer to get a single DataControlField object from the collection using array notation.

  • メソッドをGetEnumerator使用して、 System.Collections.IEnumerator実装されたオブジェクトを作成します。このオブジェクトを使用して、コレクションから項目を取得できます。Use the GetEnumerator method to create a System.Collections.IEnumerator-implemented object, which can then be used to get items from the collection.

プロパティCountは、コレクション内の項目の合計数を指定します。このプロパティは、通常、コレクションの上限を決定するために使用されます。The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. 、 、、およびAddRemoveAt各メソッドを使用して、コレクションに項目を追加したり、コレクションから項目を削除したりできます。 Remove InsertYou can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

コントロールGridViewまたはDetailsViewコントロールを使用しているDataControlField場合、 AutoGenerateColumns自動的に作成されるオブジェクト (たとえば、プロパティがtrueの場合) は、パブリックにアクセスできるフィールドコレクションに格納されません。If you are using the GridView or DetailsView control, the DataControlField objects that are automatically created (for example, when the AutoGenerateColumns property is true) are not stored in the publicly accessible fields collection. 自動的に生成されないDataControlFieldオブジェクトにのみアクセスして操作できます。You can only access and manipulate DataControlField objects that are not automatically generated.

次の表は、さまざまなデータコントロールフィールドクラスとその使用方法を示しています。The following table lists the different data control field classes and how they are used.

Parameter クラスParameter Class 説明Description
DataControlField すべてのフィールドの抽象基本クラス。The abstract base class for all fields.
BoundField ASP.NET データソースコントロールから取得したテキストまたはデータにバインドするために使用されるデータバインドコントロールフィールド。A data-bound control field that is used to bind to text or data retrieved from an ASP.NET data source control.
ButtonFieldBase 一般的なボタン機能をカプセル化するデータバインドコントロールフィールド。A data-bound control field that encapsulates general button functionality. ButtonFieldCheckBoxFieldは、このクラスから派生します。ButtonField and CheckBoxField are derived from it.
ButtonField 少なくとも1つのボタンを表示するデータバインドコントロールフィールド。A data-bound control field that displays at least one button.
CheckBoxField コントロールをCheckBox表示するデータバインドコントロールフィールド。A data-bound control field that displays a CheckBox control.
CommandField 行 (または列) によって表示されるデータに対して実行できる操作 (編集、更新、削除など) を表示するデータバインドコントロールフィールド。A data-bound control field that displays actions that can be performed on the data displayed by the row (or column), such as edit, update, or delete.
HyperLinkField コントロールをHyperLink表示するデータバインドコントロールフィールド。A data-bound control field that displays a HyperLink control.
ImageField Imageコントロールを表示するデータバインドコントロールフィールド。A data-bound control field that displays an Image control.
TemplateField データバインドコントロールにカスタムコンテンツを表示するデータバインドコントロールフィールド。A data-bound control field that displays custom content in a data-bound control.

コンストラクター

DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection()

DataControlFieldCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataControlFieldCollection class.

プロパティ

Count Count Count Count

StateManagedCollection コレクションに格納されている要素の数を取得します。Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.Count ICollection.Count ICollection.Count ICollection.Count

StateManagedCollection コレクションに格納されている要素の数を取得します。Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

StateManagedCollection コレクションが同期されている (スレッド セーフである) かどうかを示す値を取得します。Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). このメソッドは、常に false を返します。This method returns false in all cases.

(Inherited from StateManagedCollection)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

StateManagedCollection コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。Gets an object that can be used to synchronize access to the StateManagedCollection collection. このメソッドは、常に null を返します。This method returns null in all cases.

(Inherited from StateManagedCollection)
IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

StateManagedCollection コレクションが固定サイズかどうかを示す値を取得します。Gets a value indicating whether the StateManagedCollection collection has a fixed size. このメソッドは、常に false を返します。This method returns false in all cases.

(Inherited from StateManagedCollection)
IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

StateManagedCollection コレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the StateManagedCollection collection is read-only.

(Inherited from StateManagedCollection)
IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

指定したインデックス位置にある IStateManager 要素を取得します。Gets the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

StateManagedCollection コレクションがビューステートへの変更を保存しているかどうかを示す値を取得します。Gets a value indicating whether the StateManagedCollection collection is saving changes to its view state.

(Inherited from StateManagedCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

コレクション内の指定したインデックスでの DataControlField オブジェクトを取得または設定します。Gets or sets the DataControlField object at the specified index in the collection.

メソッド

Add(DataControlField) Add(DataControlField) Add(DataControlField) Add(DataControlField)

指定した DataControlField オブジェクトをコレクションの末尾に追加します。Appends the specified DataControlField object to the end of the collection.

Clear() Clear() Clear() Clear()

StateManagedCollection コレクションからすべての項目を削除します。Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
CloneFields() CloneFields() CloneFields() CloneFields()

現在のコレクションのコピーを作成します。Creates a copy of the current collection.

Contains(DataControlField) Contains(DataControlField) Contains(DataControlField) Contains(DataControlField)

特定の DataControlFieldCollection オブジェクトが DataControlField コレクションに格納されているかどうかを確認します。Determines whether the DataControlFieldCollection collection contains a specific DataControlField object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

特定の配列インデックスを開始位置として、配列に StateManagedCollection コレクションの要素をコピーします。Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Inherited from StateManagedCollection)
CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32)

DataControlFieldCollection コレクション全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。Copies the entire DataControlFieldCollection collection to a compatible one-dimensional Array, starting at the specified index of the target array.

CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32)

派生クラスでオーバーライドされた場合、IStateManager を実装するクラスのインスタンスを作成します。When overridden in a derived class, creates an instance of a class that implements IStateManager. 作成されるオブジェクトの型は、GetKnownTypes() メソッドから返されるコレクションの指定されたメンバーに基づきます。The type of object created is based on the specified member of the collection returned by the GetKnownTypes() method.

(Inherited from StateManagedCollection)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

StateManagedCollection コレクションを反復処理する反復子を返します。Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetKnownTypes() GetKnownTypes() GetKnownTypes() GetKnownTypes()

派生クラスでオーバーライドされた場合、IStateManager コレクションに格納できる StateManagedCollection 型の配列を取得します。When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain.

(Inherited from StateManagedCollection)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField)

コレクション内での指定した DataControlField オブジェクトのインデックスを調べます。Determines the index of a specific DataControlField object in the collection.

Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField)

DataControlField コレクション内の指定したインデックス位置に、指定した DataControlFieldCollection オブジェクトを挿入します。Inserts the specified DataControlField object into the DataControlFieldCollection collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnClear() OnClear() OnClear() OnClear()

派生クラスでオーバーライドされた場合、Clear() メソッドによってコレクションからすべての項目が削除される前の補足作業を実行します。When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Inherited from StateManagedCollection)
OnClearComplete() OnClearComplete() OnClearComplete() OnClearComplete()

派生クラスでオーバーライドされた場合、Clear() メソッドによってコレクションからすべての項目が削除された後の補足作業を実行します。When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection.

(Inherited from StateManagedCollection)
OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object)

派生クラスでオーバーライドされた場合、IList.Insert(Int32, Object) メソッドまたは IList.Add(Object) メソッドによってコレクションに項目が追加される前の補足作業を実行します。When overridden in a derived class, performs additional work before the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Inherited from StateManagedCollection)
OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object)

派生クラスでオーバーライドされた場合、IList.Insert(Int32, Object) メソッドまたは IList.Add(Object) メソッドによってコレクションに項目が追加された後の補足作業を実行します。When overridden in a derived class, performs additional work after the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Inherited from StateManagedCollection)
OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object)

派生クラスでオーバーライドされた場合、IList.Remove(Object) メソッドまたは IList.RemoveAt(Int32) メソッドによって、指定された項目がコレクションから削除される前の補足作業を実行します。When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Inherited from StateManagedCollection)
OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object)

派生クラスでオーバーライドされた場合、IList.Remove(Object) メソッドまたは IList.RemoveAt(Int32) メソッドによって、指定された項目がコレクションから削除された後の補足作業を実行します。When overridden in a derived class, performs additional work after the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Inherited from StateManagedCollection)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

派生クラスでオーバーライドされた場合、StateManagedCollection コレクションの要素を検証します。When overridden in a derived class, validates an element of the StateManagedCollection collection.

(Inherited from StateManagedCollection)
Remove(DataControlField) Remove(DataControlField) Remove(DataControlField) Remove(DataControlField)

指定した DataControlField オブジェクトを DataControlFieldCollection コレクションから削除します。Removes the specified DataControlField object from the DataControlFieldCollection collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

指定したインデックス位置にある DataControlField オブジェクトを DataControlFieldCollection コレクションから削除します。Removes the DataControlField object at the specified index from the DataControlFieldCollection collection.

SetDirty() SetDirty() SetDirty() SetDirty()

強制的に StateManagedCollection コレクション全体をビューステートにシリアル化します。Forces the entire StateManagedCollection collection to be serialized into view state.

(Inherited from StateManagedCollection)
SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object)

派生クラスでオーバーライドされた場合、コレクションに格納されている object に、変更情報だけでなく、その状態全体をビューステートに記録するよう指示します。When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information.

(Inherited from StateManagedCollection)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

FieldsChanged FieldsChanged FieldsChanged FieldsChanged

コレクション内のフィールドが変更されると発生します。通常は、Clear()Insert(Int32, DataControlField)Remove(DataControlField)Add(DataControlField) のいずれかのメソッド呼び出しの結果として発生します。Occurs when the fields in the collection change, usually as the result of a Clear(), Insert(Int32, DataControlField), Remove(DataControlField) or Add(DataControlField) method call. コレクション内の DataControlField によって FieldChanged イベントが発生すると、このイベントが必ず発生します。This event is also raised anytime a DataControlField in the collection raises its FieldChanged event.

明示的なインターフェイスの実装

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

StateManagedCollection コレクションを反復処理する反復子を返します。Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

項目を StateManagedCollection コレクションに追加します。Adds an item to the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Clear() IList.Clear() IList.Clear() IList.Clear()

StateManagedCollection コレクションからすべての項目を削除します。Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

StateManagedCollection コレクションに特定の値が格納されているかどうかを判断します。Determines whether the StateManagedCollection collection contains a specific value.

(Inherited from StateManagedCollection)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

StateManagedCollection コレクション内での指定した項目のインデックスを調べます。Determines the index of a specified item in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

StateManagedCollection コレクション内の指定したインデックスの位置に項目を挿入します。Inserts an item into the StateManagedCollection collection at the specified index.

(Inherited from StateManagedCollection)
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

指定したオブジェクトのうち、StateManagedCollection コレクションで最初に出現したオブジェクトを削除します。Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

指定したインデックス位置にある IStateManager 要素を削除します。Removes the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

StateManagedCollection コレクションと、そのコレクションに格納されている IStateManager 項目の以前に保存されたビューステートを復元します。Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Inherited from StateManagedCollection)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

ページがサーバーにポストバックされた時間以降に発生した、StateManagedCollection コレクションとその各 IStateManager オブジェクトへの変更を保存します。Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Inherited from StateManagedCollection)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

StateManagedCollection コレクションとその各 IStateManager オブジェクトに自身のビューステートへの変更を追跡させ、同じページに対する要求間でこれらが永続化されるようにします。Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page.

(Inherited from StateManagedCollection)

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください