Control.OnBubbleEvent(Object, EventArgs) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.
protected:
virtual bool OnBubbleEvent(System::Object ^ source, EventArgs ^ args);
protected virtual bool OnBubbleEvent (object source, EventArgs args);
abstract member OnBubbleEvent : obj * EventArgs -> bool
override this.OnBubbleEvent : obj * EventArgs -> bool
Protected Overridable Function OnBubbleEvent (source As Object, args As EventArgs) As Boolean
Parametry
- source
- Object
Źródło zdarzenia.
Zwraca
true
jeśli zdarzenie zostało anulowane; w przeciwnym razie , false
. Wartość domyślna to false
.
Przykłady
Poniższy przykład zastępuje metodę OnBubbleEvent w niestandardowej kontrolce serwera ASP.NET. ParentControl
Ta metoda jest wywoływana, gdy podrzędna kontrolka ParentControl
wywołuje metodę RaiseBubbleEvent . W takim przypadku ParentControl
klasa zapisuje dwa ciągi na stronie zawierającej ASP.NET, pierwszy z informacją, że została wywołana jego OnBubbleEvent metoda, drugi identyfikujący kontrolę RaiseBubbleEvent źródła metody.
public class ParentControl : Control
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override bool OnBubbleEvent(object sender, EventArgs e)
{
Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.");
Context.Response.Write("<br>Source of event is: " + sender.ToString());
return true;
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render( HtmlTextWriter myWriter)
{
myWriter.Write("ParentControl");
RenderChildren(myWriter);
}
}
Public Class ParentControl
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Function OnBubbleEvent(sender As Object, e As EventArgs) As Boolean
Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.")
Context.Response.Write(("<br>Source of event is: " + sender.ToString()))
Return True
End Function 'OnBubbleEvent
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(myWriter As HtmlTextWriter)
myWriter.Write("ParentControl")
RenderChildren(myWriter)
End Sub
End Class
_
Uwagi
ASP.NET kontrolek serwera, takich jak kontrolki Repeater, DataList i GridView sieci Web mogą zawierać kontrolki podrzędne, które zgłaszają zdarzenia. Na przykład każdy wiersz w kontrolce GridView może zawierać jeden lub więcej przycisków utworzonych dynamicznie przez szablony. Zamiast każdego przycisku, który podnosi zdarzenie indywidualnie, zdarzenia z zagnieżdżonych kontrolek są "bąbelkowe" — czyli są wysyłane do kontenera nazewnictwa. Kontener nazewnictwa z kolei zgłasza ogólne zdarzenie o nazwie RowCommand z wartościami parametrów. Te wartości umożliwiają określenie poszczególnych kontrolek, które wzbudziły oryginalne zdarzenie. Odpowiadając na to pojedyncze zdarzenie, można uniknąć konieczności pisania poszczególnych metod obsługi zdarzeń dla kontrolek podrzędnych.