DataBoundControl.GetData Méthode

Définition

Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

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.The DataSourceView that the data-bound control uses to perform data operations. Si la propriété DataMember est définie, un DataSourceView nommé spécifique est retourné ; sinon, le DataSourceView par défaut est retourné.If the DataMember property is set, a specific, named DataSourceView is returned; otherwise, the default DataSourceView is returned.

Exceptions

Les propriétés DataSource et DataSourceID sont toutes les deux définies.Both the DataSource and DataSourceID properties are set.

- ou --or- La propriété DataMember est définie, mais un objet DataSourceView de ce nom n'existe pas.The DataMember property is set but a DataSourceView object by that name does not exist.

Exemples

L’exemple de code suivant montre comment la GetData méthode est appelée pour récupérer l' DataSourceView objet 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.The following code example demonstrates how the GetData method is called to retrieve the DataSourceView object from the associated data source control and the Select method is called to retrieve the data. Cet exemple de code fait partie d’un exemple plus complet fourni pour la DataBoundControl classe.This code example is part of a larger example provided for the DataBoundControl class.

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 du contrôle de source de données associé en appelant la GetDataSource méthode.The GetData method retrieves a DataSourceView object from the associated data source control by calling the GetDataSource method. Si la DataSource propriété est utilisée pour identifier une source de données, un DataSourceView objet par défaut est créé.If the DataSource property is used to identify a data source, a default DataSourceView object is created.

S’applique à

Voir aussi