Control.OnBubbleEvent(Object, EventArgs) Metoda

Definicja

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

C#
protected virtual bool OnBubbleEvent(object source, EventArgs args);

Parametry

source
Object

Źródło zdarzenia.

args
EventArgs

EventArgs Obiekt zawierający dane 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.

C#
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);
   }
}

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.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też