DataBoundControl.GetData Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft ein DataSourceView Objekt ab, das vom datengebundenen Steuerelement zum Ausführen von Datenvorgängen verwendet wird.

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

Das DataSourceView datengebundene Steuerelement zum Ausführen von Datenvorgängen. Wenn die DataMember Eigenschaft festgelegt ist, wird ein bestimmter benannter Name DataSourceView zurückgegeben. Andernfalls wird der Standardwert DataSourceView zurückgegeben.

Ausnahmen

InvalidOperationException

Sowohl die Eigenschaften DataSourceID als auch die DataSource Eigenschaften werden festgelegt.

- oder -

Die DataMember Eigenschaft wird 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 DataSourceView Objekt aus dem 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 verwendet wird, um eine Datenquelle zu identifizieren, wird ein Standardobjekt DataSourceView erstellt.

Weitere Informationen

• GetDataSource()
• DataMember