DataBoundControl.GetData Méthode

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.

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

Retours

DataSourceView

Le DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. Si la propriété DataMember est définie, un DataSourceView nommé spécifique est retourné ; sinon, le DataSourceView par défaut est retourné.

Exceptions

InvalidOperationException

Les propriétés DataSource et DataSourceID sont toutes les deux définies.

• ou - La propriété DataMember est définie, mais un objet DataSourceView de ce nom n'existe pas.

Exemples

L’exemple de code suivant montre comment la GetData méthode est appelée pour récupérer l’objet DataSourceView à partir du contrôle de source de données associé et que la Select méthode est appelée pour récupérer les données. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataBoundControl classe.

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

Remarques

La GetData méthode récupère un DataSourceView objet à partir du contrôle de source de données associé en appelant la GetDataSource méthode. Si la DataSource propriété est utilisée pour identifier une source de données, un objet par défaut DataSourceView est créé.

Voir aussi

• GetDataSource()
• DataMember