Control.LoadViewStateByID プロパティ

定義

コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。Gets a value indicating whether the control participates in loading its view state by ID instead of index.

protected:
 property bool LoadViewStateByID { bool get(); };
protected bool LoadViewStateByID { get; }
member this.LoadViewStateByID : bool
Protected ReadOnly Property LoadViewStateByID As Boolean

プロパティ値

コントロールが ID によりビューステートを読み込む場合は true。それ以外の場合は falsetrue if the control loads its view state by ID; otherwise, false. 既定値は false です。The default value is false.

注釈

既定では、親コントロールが作成した子コントロールにビューステートを読み込むときに、親コントロールの Controls コレクション内の各子コントロールの位置によって、この操作が行われます。By default, when a parent control loads view state into child controls it creates, it does this by the position of each child control in the parent control's Controls collection. ビューステートが最初に適用されると、すべての子コントロールが作成されていない可能性があります。When view state is initially applied, all child controls might not have been created. この場合、まだ作成されていないコントロールのビューステートは保存され、後で子コントロールが作成されるときに適用されます。In this case, the view state for controls not yet created is saved, and applied when the child controls are created later.

親コントロールがビューステートを子コントロールに適用するには、次の2つの条件が満たされている必要があります。For a parent control to apply view state to its child controls, two conditions must be met:

  • ポストバック時に、親コントロールは、コントロールの順序が一貫しているように、前の要求とまったく同じ順序で子コントロールを作成する必要があります。On postback, the parent control must create the child controls in exactly the same order as the previous request so that the order of the controls remains consistent.

  • ポストバック後に、作成された子コントロールを親コントロールの Controls コレクションの末尾に追加する必要があります。After postback, any child controls created must be added to the end of the parent control's Controls collection.

この2つの条件を満たすことができない場合、子コントロールの作成が遅延した場合のように、親コントロールは IDを使用してビューステートを読み込むことができます。If these two conditions cannot be met, as in the case of the delayed creation of a child control, the parent control can load view state by using ID. LoadViewStateByID プロパティを trueに設定するには、親コントロールの ViewStateModeByIdAttribute メタデータ属性を使用します。To set the LoadViewStateByID property to true, use the ViewStateModeByIdAttribute metadata attribute for the parent control.

適用対象

こちらもご覧ください