BaseDataBoundControl.OnDataBound(EventArgs) Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Genera l'evento DataBound.

protected:
 virtual void OnDataBound(EventArgs ^ e);

protected virtual void OnDataBound (EventArgs e);

abstract member OnDataBound : EventArgs -> unit
override this.OnDataBound : EventArgs -> unit

Protected Overridable Sub OnDataBound (e As EventArgs)

Parametri

e

EventArgs

Oggetto EventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene illustrato come viene usato il OnDataBound metodo per generare l'evento DataBound da una classe di controllo associata a dati derivata. Dopo aver usato i GetData metodi e PerformDataBinding per associare i dati al controllo, il controllo associato ai dati genera l'evento per segnalare che il DataBound data binding è stato completato. Questo esempio di codice fa parte di un esempio più grande fornito per 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

Commenti

Questo metodo notifica a un controllo server che qualsiasi logica di associazione dati associata al controllo è stata completata.

Importante

Il DataBind metodo è bloccato su tutti i controlli derivati da BaseDataBoundControl. I controlli associati a dati devono eseguire l'override PerformDataBinding anziché il DataBind metodo per associare i dati. Se DataBind viene eseguito l'override, gli OnDataBinding eventi e OnDataBound vengono generati fuori ordine.

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni, vedere la gestione e generazione di eventi.

Il metodo OnDataBound consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.

Note per gli eredi

Quando si esegue l'override OnDataBound(EventArgs) in una classe derivata, assicurarsi di chiamare il metodo della OnDataBound(EventArgs) classe base in modo che i delegati registrati ricevano l'evento.

Vedi anche

• OnDataBinding(EventArgs)