DataControlFieldCollection クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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、オブジェクトを格納IStateManagerするために特に使用される抽象基本コレクションクラスからStateManagedCollection派生します。

オブジェクトは StateManagedCollection 、オブジェクトの動作に影響します DataControlFieldCollection 。 DataControlField 状態が復元されると、コレクションに動的に追加されたオブジェクトがコントロールに再追加されます。つまり、各ポストバックではなく 1 回だけフィールドを追加、削除、または変更する必要があります。これは、ASP.NET のほとんどのコレクション型が必要とするためです。

(このクラスはDataControlFieldインターフェイスをIStateManager実装します。これにより、その状態をビューステート ASP.NET 格納できます。 )

クラスを DataControlFieldCollection 使用して、一連の DataControlField オブジェクトをプログラムで管理します。これらのフィールドを宣言によって定義する方が一般的であることに注意してください。

クラスの適切なメソッドDataControlFieldCollectionを使用して、オブジェクトを追加、挿入、および削除DataControlFieldできます。プログラムによってコレクションからオブジェクトを取得 DataControlField するには、次のいずれかの方法を使用します。

インデクサーを使用して、配列表記を使用してコレクションから 1 つの DataControlField オブジェクトを取得します。
メソッドを GetEnumerator 使用して-implemented オブジェクトを System.Collections.IEnumerator作成し、それを使用してコレクションから項目を取得できます。

このプロパティは Count コレクション内の項目の合計数を指定し、通常はコレクションの上限を決定するために使用されます。、、Removeおよびメソッドを使用してAdd Insert、コレクションに項目を追加したり、コレクションから項目をRemoveAt削除したりできます。

またはコントロールをGridView使用している場合、DataControlField自動的に作成されるオブジェクト (プロパティがある場合AutoGenerateColumnsなど) はtrue、パブリックにアクセス可能なフィールドコレクションに格納DetailsViewされません。自動的に生成されないオブジェクトにのみアクセスして操作 DataControlField できます。

次の表に、さまざまなデータコントロールフィールドクラスとその使用方法を示します。

Parameter クラス	[説明]
DataControlField	すべてのフィールドの抽象基底クラス。
BoundField	ASP.NET データソースコントロールから取得したテキストまたはデータにバインドするために使用されるデータバインドコントロールフィールド。
ButtonFieldBase	一般的なボタン機能をカプセル化するデータバインドコントロールフィールド。 ButtonField から CheckBoxField 派生します。
ButtonField	少なくとも 1 つのボタンを表示するデータバインドコントロールフィールド。
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 コレクション全体を互換性のある 1 次元の 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)

events

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 に変換します。

適用対象

次の方法で共有