Control.RaiseBubbleEvent(Object, EventArgs) Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.

protected:
 void RaiseBubbleEvent(System::Object ^ source, EventArgs ^ args);

protected void RaiseBubbleEvent (object source, EventArgs args);

member this.RaiseBubbleEvent : obj * EventArgs -> unit

Protected Sub RaiseBubbleEvent (source As Object, args As EventArgs)

Parameter

source

Object

Sumber dari peristiwa tersebut.

args

EventArgs

Objek EventArgs yang berisi data peristiwa.

Contoh

Contoh kode berikut menunjukkan cara membuat kelas kustom, ChildControl, menimpa Button.OnClick metode untuk memanggil RaiseBubbleEvent metode yang mengirim Button.Click peristiwa ke kontrol server ASP.NET induknya. Ketika pengguna mengklik tombol di halaman ASP.NET yang menyertakan instans ChildControlOnBubbleEvent , itu meningkatkan metode pada kontrol induk yang berisi instans ChildControl dan menulis string "Metode OnClick kelas ChildControl dipanggil" ke halaman.

public class ChildControl : Button
{
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override void OnClick(EventArgs e) 
   {
      base.OnClick(e);
      Context.Response.Write("<br><br>ChildControl's OnClick called.");
      // Bubble this event to parent.
      RaiseBubbleEvent(this, e);
   }

Public Class ChildControl
   Inherits Button
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Sub OnClick(e As EventArgs)
      MyBase.OnClick(e)
      Context.Response.Write("<br><br>ChildControl's OnClick called.")
      ' Bubble this event to parent.
      RaiseBubbleEvent(Me, e)
   End Sub
End Class

Keterangan

ASP.NET kontrol server seperti Repeaterkontrol , dan DataListGridView Web dapat berisi kontrol anak yang memunculkan peristiwa. Misalnya, setiap baris dalam GridView kontrol dapat berisi satu atau beberapa tombol yang dibuat secara dinamis oleh templat. Daripada setiap tombol yang menaikkan peristiwa satu per satu, peristiwa dari kontrol berlapis "bertumpuk" - yaitu, mereka dikirim ke induk kontrol. Induk pada gilirannya memunculkan peristiwa generik yang disebut RowCommand dengan nilai parameter. Nilai-nilai ini memungkinkan Anda menentukan kontrol individual mana yang menaikkan peristiwa asli. Dengan menanggapi peristiwa tunggal ini, Anda dapat menghindari keharusan menulis metode penanganan peristiwa individual untuk kontrol anak.

Meskipun Anda tidak dapat mengambil alih metode ini, kontrol yang dapat Anda tulis dapat menangani atau menaikkan peristiwa yang menggelegak dengan mengambil alih OnBubbleEvent metode .

Lihat juga

• OnBubbleEvent(Object, EventArgs)