DataBoundControl.GetData Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: