BaseDataBoundControl.OnDataBound(EventArgs) Metoda

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

DataBound Vyvolá událost.

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)

Parametry

e

EventArgs

Objekt EventArgs , který obsahuje data události.

Příklady

Následující příklad kódu ukazuje, jak OnDataBound se metoda používá k vyvolání DataBound události odvozenou třídou ovládacího prvku vázaného na data. Po použití GetData metod a PerformDataBinding k vytvoření vazby DataBound dat s ovládacím prvku vyvolá ovládací prvek vázaný na data událost, aby signalizoval, že je datová vazba dokončena. Tento příklad kódu je součástí většího příkladu DataBoundControl pro třídu.

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

Poznámky

Tato metoda upozorní ovládací prvek serveru, že se dokončila jakákoli logika datové vazby přidružená k tomuto ovládacímu prvku.

Důležité

Metoda DataBind je zapečetěna na všech ovládacích prvcích odvozených z BaseDataBoundControl. Ovládací prvky vázané na data by měly přepsat PerformDataBinding místo DataBind metody pro vytvoření vazby dat. Pokud DataBind je přepsán, OnDataBinding události a OnDataBound jsou vyvolány mimo pořadí.

Vyvolání události spustí obslužnou rutinu události prostřednictvím delegáta. Další informace najdete v tématu Zpracování a vyvolávání událostí.

Metoda OnDataBound také umožňuje odvozeným třídám zpracovat událost bez připojení delegáta. Toto je upřednostňovaná technika pro zpracování události v odvozené třídě.

Poznámky pro dědice

Při přepsání OnDataBound(EventArgs) v odvozené třídě nezapomeňte volat metodu základní třídy, OnDataBound(EventArgs) aby registrovaní delegáti obdrželi událost.

Viz také

• OnDataBinding(EventArgs)