BaseDataBoundControl.RequiresDataBinding プロパティ

.NET Framework クラス ライブラリ リファレンス

BaseDataBoundControl.RequiresDataBinding プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DataBind メソッドを呼び出す必要があるかどうか示す値を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Property RequiresDataBinding As
 Boolean

Visual Basic (使用法)

Dim value As Boolean

value = Me.RequiresDataBinding

Me.RequiresDataBinding = value

C#

protected bool RequiresDataBinding { get;
 set; }

C++

protected:
property bool RequiresDataBinding {
    bool get ();
    void set (bool value);
}

J#

/** @property */
protected boolean get_RequiresDataBinding ()

/** @property */
protected void set_RequiresDataBinding (boolean
 value)

JScript

protected function get RequiresDataBinding
 () : boolean

protected function set RequiresDataBinding
 (value : boolean)

プロパティ値
データ バインド コントロールの表示前に、そのコントロールの DataBind メソッドを呼び出す必要がある場合は、 true が返されます。それ以外の場合は false が返されます。

解説

データ バインド コントロールがページへの出力の表示を既に開始している場合、その時点の HTTP 要求がコールバックでない場合、バインドするデータ ソース コントロールを DataSourceID プロパティを使用して指定している場合に、RequiresDataBinding プロパティに true を設定すると、DataBind メソッドが直ちに呼び出されます。この場合、実際に RequiresDataBinding プロパティに true が設定されることはありません。

使用例

次のコード例では、派生データ バインド コントロール クラスで RequiresDataBinding プロパティを使用する方法を示します。GetData メソッドでデータを取得し、PerformDataBinding メソッドでそのデータをコントロールにバインドした後、RequiresDataBinding プロパティに false を設定し、さらに MarkAsDataBound メソッドを呼び出して、コントロールのバインドが完了していること、および現在のページの有効期間中はこのプロパティが必要ないことを示しています。このコード例は、DataBoundControl クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Protected Overrides Sub
 PerformSelect()

    ' Call OnDataBinding here if bound to a data source using the 
    ' DataSource property (instead of a DataSourceID) because the 
    ' data-binding statement is evaluated before the call to GetData.
    If Not IsBoundUsingDataSourceID Then
        OnDataBinding(EventArgs.Empty)
    End If

    ' The GetData method retrieves the DataSourceView object from the
 
    ' IDataSource associated with the data-bound control.          
  
    GetData().Select(CreateDataSourceSelectArguments(), _
        AddressOf OnDataSourceViewSelectCallback)

    ' The PerformDataBinding method has completed.
    RequiresDataBinding = False
    MarkAsDataBound()

    ' Raise the DataBound event.
        OnDataBound(EventArgs.Empty)

End Sub 'PerformSelect

C#

protected override void PerformSelect() { 
           

   // Call OnDataBinding here if bound to a data source using the
   // DataSource property (instead of a DataSourceID), because the
   // databinding statement is evaluated before the call to GetData.
       
    if (! IsBoundUsingDataSourceID) {
        OnDataBinding(EventArgs.Empty);
    }            
    
    // The GetData method retrieves the DataSourceView object from 
 
    // the IDataSource associated with the data-bound control.     
       
    GetData().Select(CreateDataSourceSelectArguments(), 
        OnDataSourceViewSelectCallback);
    
    // The PerformDataBinding method has completed.
    RequiresDataBinding = false;
    MarkAsDataBound();
    
    // Raise the DataBound event.
    OnDataBound(EventArgs.Empty);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
BaseDataBoundControl クラス
BaseDataBoundControl メンバ
System.Web.UI.WebControls 名前空間
DataBind
BaseDataBoundControl.DataSourceID プロパティ