BaseDataBoundControl.IsBoundUsingDataSourceID プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

BaseDataBoundControl.IsBoundUsingDataSourceID プロパティ

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

DataSourceID プロパティが設定されているかどうか示す値を取得します。

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

Visual Basic (宣言)

Protected ReadOnly Property
 IsBoundUsingDataSourceID As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = Me.IsBoundUsingDataSourceID

protected bool IsBoundUsingDataSourceID { get;
 }

C++

protected:
property bool IsBoundUsingDataSourceID {
    bool get ();
}

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

JScript

protected function get IsBoundUsingDataSourceID
 () : boolean

プロパティ値
DataSourceID プロパティに String.Empty 以外の値が設定されている場合は true が返されます。これ以外の場合は false が返されます。

解説

GridView、DetailsView、FormView、および Menu などのコントロールは、IsBoundUsingDataSourceID プロパティを使用して、データバインドコントロールが ObjectDataSource または SqlDataSource などの ASP.NET 2.0 データソースコントロールにバインドされているかどうかを判断します。

使用例

次のコード例では、派生データバインドコントロールクラスで IsBoundUsingDataSourceID プロパティを使用する方法を示します。PerformSelect メソッドの実装では、DataBinding イベントを発生させる必要があるかどうか判断するために、IsBoundUsingDataSourceID プロパティを使用しています。このコード例は、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

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);
}