BaseDataBoundControl.OnDataBound(EventArgs) Yöntem

Tanım

Olayını oluşturur DataBound .Raises the DataBound event.

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)

Parametreler

e
EventArgs

EventArgsOlay verilerini içeren bir nesne.An EventArgs object that contains the event data.

Örnekler

Aşağıdaki kod örneği, OnDataBound yönteminin DataBound türetilmiş bir veri bağlantılı denetim sınıfına göre olayını yükseltmek için nasıl kullanıldığını gösterir.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Verileri GetData PerformDataBinding denetime bağlamak için ve yöntemlerini kullandıktan sonra veriye bağlı denetim, DataBound olayı veri bağlamanın tamamlandığını işaret etmek üzere başlatır.After using the GetData and PerformDataBinding methods to bind data to the control, the data-bound control raises the DataBound event to signal that data binding is complete. Bu kod örneği, sınıfı için sağlanmış daha büyük bir örneğin bir parçasıdır DataBoundControl .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

Açıklamalar

Bu yöntem, bir sunucu denetimine denetimle ilişkili herhangi bir veri bağlama mantığının tamamlandığını bildirir.This method notifies a server control that any data binding logic associated with the control has completed.

Önemli

DataBindYöntemi öğesinden türetilmiş tüm denetimlerde mühürlenmiş BaseDataBoundControl .The DataBind method is sealed on all controls derived from BaseDataBoundControl. Veriye bağlı denetimler PerformDataBinding , DataBind veri bağlama yöntemi yerine geçersiz kılınmalıdır.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. DataBindGeçersiz kılınırsa, OnDataBinding ve OnDataBound olayları sırayla çıkarılır.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Olay bildirmek, bir temsilci yoluyla olay işleyicisini çağırır.Raising an event invokes the event handler through a delegate. Daha fazla bilgi için bkz. olayları işleme veoluşturma.For more information, see Handling and Raising Events.

OnDataBoundYöntemi, türetilmiş sınıfların bir temsilciyi iliştirmeden olayı işlemesini de sağlar.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Bu, türetilmiş bir sınıftaki olayı işlemek için tercih edilen tekniktir.This is the preferred technique for handling the event in a derived class.

Devralanlara Notlar

OnDataBound(EventArgs)Türetilmiş bir sınıfta geçersiz kılma yaparken, OnDataBound(EventArgs) kayıtlı temsilcilerin olayı alabilmesi için temel sınıf ' metodunu çağırdığınızdan emin olun.When overriding OnDataBound(EventArgs) in a derived class, be sure to call the base class' OnDataBound(EventArgs) method so that registered delegates receive the event.

Şunlara uygulanır

Ayrıca bkz.