Control.OnBubbleEvent(Object, EventArgs) Metoda

Definice

Určuje, zda je událost ovládacího prvku Server předána hierarchii ovládacích prvků serveru uživatelského rozhraní stránky.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

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

Zdroj událostiThe source of the event.

args
EventArgs

EventArgsObjekt, který obsahuje data události.An EventArgs object that contains the event data.

Návraty

Boolean

truePokud byla událost zrušena; v opačném případě false .true if the event has been canceled; otherwise, false. Výchozí formát je false.The default is false.

Příklady

Následující příklad přepisuje OnBubbleEvent metodu ve vlastním ovládacím prvku ASP.NET Server ParentControl .The following example overrides the OnBubbleEvent method in a custom ASP.NET server control, ParentControl. Tato metoda je vyvolána, když podřízený ovládací prvek ParentControl volá RaiseBubbleEvent metodu.This method is invoked when a child control of ParentControl calls the RaiseBubbleEvent method. Pokud k tomu dojde, ParentControl Třída zapíše dva řetězce na obsahující stránku ASP.NET, první údaj o tom, že byla jeho OnBubbleEvent metoda volána, druhá identifikuje správu zdrojového kódu RaiseBubbleEvent metody.When this happens, the ParentControl class writes two strings to the containing ASP.NET page, the first stating that its OnBubbleEvent method has been called, the second identifying the source control of the RaiseBubbleEvent method.

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
 _

Poznámky

Ovládací prvky ASP.NET serveru, jako jsou Repeater , DataList a GridView webové ovládací prvky mohou obsahovat podřízené ovládací prvky, které vyvolávají události.ASP.NET server controls such as the Repeater, DataList and GridView Web controls can contain child controls that raise events. Každý řádek v GridView ovládacím prvku například může obsahovat jeden nebo více tlačítek vytvořených dynamicky šablonou.For example, each row in a GridView control can contain one or more buttons created dynamically by templates. Místo toho, aby se každé tlačítko vyvolalo událost jednotlivě, události z vnořených ovládacích prvků jsou "bublinové" – to znamená, že jsou odesílány do názvového kontejneru.Rather than each button raising an event individually, events from the nested controls are "bubbled" - that is, they are sent to the naming container. Názvový kontejner zase vyvolá obecnou událost nazvanou RowCommand s hodnotami parametrů.The naming container in turn raises a generic event called RowCommand with parameter values. Tyto hodnoty umožňují určit, který jednotlivý ovládací prvek vyvolal původní událost.These values allow you to determine which individual control that raised the original event. Tím, že odpovíte na tuto jedinou událost, se můžete vyhnout nutnosti psát jednotlivé metody zpracování událostí pro podřízené ovládací prvky.By responding to this single event, you can avoid having to write individual event-handling methods for child controls.

Platí pro

Viz také