Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Zaregistruje ovládací prvek serveru ASP.NET jako ovládací prvek, který vyžaduje vyvolání události při zpracování ovládacího prvku na objektu Page .

public:
 virtual void RegisterRequiresRaiseEvent(System::Web::UI::IPostBackEventHandler ^ control);

public virtual void RegisterRequiresRaiseEvent(System.Web.UI.IPostBackEventHandler control);

abstract member RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit
override this.RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit

Public Overridable Sub RegisterRequiresRaiseEvent (control As IPostBackEventHandler)

Parametry

control

IPostBackEventHandler

Ovládací prvek, který se má zaregistrovat.

Příklady

Následující příklad kódu používá metodu RegisterRequiresRaiseEvent k registraci ovládacího prvku webového Button serveru, který vyžaduje vyvolání události. Po registraci prvního Button ovládacího prvku můžete způsobit, že druhý Button ovládací prvek deklarovaný v kódu zveřejní výsledky události kliknutí prvního tlačítka na stránku.

void DisplayUserName(Object sender, EventArgs ea) 
{
   Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
   // Raise a post back event for a control.
   this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
   // Register a control as one that requires postback handling.
   this.RegisterRequiresRaiseEvent(userButton);
}

    Sub DisplayUserName(Sender As Object, e As EventArgs) 
       Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
    End Sub

   Sub MyRaiseEvent(Sender As Object, e As EventArgs)
       'Raises a post back event for a control.
        Me.RaisePostBackEvent(userButton, "")
   End Sub 
    
    Sub Page_Load(Sender As Object, e As EventArgs)

      'Registers a control as one that requires postback handling
      Me.RegisterRequiresRaiseEvent(userButton)
  End Sub

Poznámky

Pro každý požadavek na stránku je možné zaregistrovat pouze jeden ovládací prvek serveru. Musí RegisterRequiresRaiseEvent být použit, pokud ovládací prvek neobsahuje jeho ID ovládacího prvku do dat formuláře post data. Také ovládací prvek, který je zaregistrovaný, musí implementovat IPostBackEventHandler rozhraní.

Viz také

• IsPostBack