Teilen über

DataBoundControl.GetData Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft ein DataSourceView-Objekt ab, mit dessen Hilfe das datengebundene Steuerelement Datenvorgänge ausführt.

protected:
 virtual System::Web::UI::DataSourceView ^ GetData();
protected virtual System.Web.UI.DataSourceView GetData ();
abstract member GetData : unit -> System.Web.UI.DataSourceView
override this.GetData : unit -> System.Web.UI.DataSourceView
Protected Overridable Function GetData () As DataSourceView

Gibt zurück

DataSourceView

Die DataSourceView, mit deren Hilfe das datengebundene Steuerelement Datenvorgänge ausführt. Wenn die DataMember-Eigenschaft festgelegt ist, wird eine bestimmte benannte DataSourceView zurückgegeben, andernfalls wird die standardmäßige DataSourceView zurückgegeben.

Ausnahmen

InvalidOperationException

Sowohl die DataSource-Eigenschaft als auch die DataSourceID-Eigenschaft sind festgelegt.

- oder -

Die DataMember-Eigenschaft ist festgelegt, aber ein DataSourceView-Objekt mit diesem Namen ist nicht vorhanden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetData -Methode aufgerufen wird, um das -Objekt aus dem DataSourceView zugeordneten Datenquellensteuerelement abzurufen, und die Select -Methode wird aufgerufen, um die Daten abzurufen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl-Klasse bereitgestellt wird.

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

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

Hinweise

Die GetData -Methode ruft ein DataSourceView -Objekt aus dem zugeordneten Datenquellensteuerelement ab, indem die GetDataSource -Methode aufgerufen wird. Wenn die DataSource -Eigenschaft zum Identifizieren einer Datenquelle verwendet wird, wird ein Standardobjekt DataSourceView erstellt.

Gilt für:

Weitere Informationen