DataBoundControl.GetData メソッドとは何？わかりやすく解説 Weblio辞書

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

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

DataBoundControl.GetData メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

データ操作を実行するために、データバインドコントロールが使用する DataSourceView オブジェクトを取得します。

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

Visual Basic (宣言)

Protected Overridable Function
 GetData As DataSourceView

Visual Basic (使用法)

Dim returnValue As DataSourceView

returnValue = Me.GetData

protected virtual DataSourceView GetData ()

C++

protected:
virtual DataSourceView^ GetData ()

protected DataSourceView GetData ()

JScript

protected function GetData () : DataSourceView

戻り値
データ操作を実行するためにデータバインドコントロールが使用する DataSourceView。DataMember プロパティが設定されている場合、特定の、名前付き DataSourceView が返されます。それ以外の場合は、既定の DataSourceView が返されます。

例外

例外の種類	条件
InvalidOperationException	DataSource プロパティと DataSourceID プロパティの両方が設定されています。または DataMember プロパティが設定されていますが、その名前の DataSourceView オブジェクトが存在しません。

例外の種類

条件

InvalidOperationException

DataSource プロパティと DataSourceID プロパティの両方が設定されています。

または

DataMember プロパティが設定されていますが、その名前の DataSourceView オブジェクトが存在しません。

解説

GetData メソッドは、GetDataSource メソッドを呼び出すことで、関連するデータソースコントロールから DataSourceView オブジェクトを取得します。DataSource プロパティを使用してデータソースを指定すると、既定の DataSourceView オブジェクトが作成されます。

使用例

GetData メソッドを呼び出して、関連するデータソースコントロールから DataSourceView オブジェクトを取得する方法、および Select メソッドを呼び出して、データを取得する方法を次のコード例に示します。このコード例は、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);
}