ClientScriptManager.GetPostBackEventReference Methode

Definition

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server.

Überlädt

GetPostBackEventReference(Control, String, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string to use in a client event to cause postback to the server. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Registriert den Ereignisverweis optional für die Validierung.Optionally, registers the event reference for validation.

GetPostBackEventReference(PostBackOptions, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird vom angegebenen PostBackOptions-Objekt definiert.The reference string is defined by the specified PostBackOptions object. Registriert den Ereignisverweis optional für die Validierung.Optionally, registers the event reference for validation.

GetPostBackEventReference(PostBackOptions)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird von der angegebenen PostBackOptions-Instanz definiert.The reference string is defined by the specified PostBackOptions instance.

GetPostBackEventReference(Control, String)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

GetPostBackEventReference(Control, String, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string to use in a client event to cause postback to the server. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Registriert den Ereignisverweis optional für die Validierung.Optionally, registers the event reference for validation.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, bool registerForEventValidation);
public string GetPostBackEventReference (System.Web.UI.Control control, string argument, bool registerForEventValidation);
member this.GetPostBackEventReference : System.Web.UI.Control * string * bool -> string

Parameter

control
Control

Das Server-Control, das das Postback auf dem Server verarbeitet.The server Control that processes the postback on the server.

argument
String

Eine Zeichenfolge optionaler Argumente, die an control übergeben werden sollen.A string of optional arguments to pass to control.

registerForEventValidation
Boolean

true, um den Ereignisverweis für die Validierung zu registrieren, andernfalls false.true to register the event reference for validation; otherwise, false.

Gibt zurück

Eine Zeichenfolge, die das Postback initiiert, wenn sie auf dem Client als Skript behandelt wird.A string that, when treated as script on the client, initiates the postback.

Ausnahmen

Der angegebene Control ist gleich null.The specified Control is null.

Hinweise

Verwenden Sie die IPostBackEventHandler -Direktive Page, um die-Schnittstelle für zu implementieren.To implement the IPostBackEventHandler interface for a Page, use the directive.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet UseSubmitBehavior werden, falsewenn die-Eigenschaft ist.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Client Postback-Ereignis für Button das-Steuerelement zurück.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Wenn registerForEventValidation true ist, ruft GetPostBackEventReference(PostBackOptions, Boolean) RegisterForEventValidation(String, String) die-Methode die-Methode auf, um den Ereignis Verweis für die Validierung mit einer eindeutigen Steuerelement-ID zu registrieren, die das Client Steuerelement darstellt, das das Ereignis erzeugt.If registerForEventValidation is true, the GetPostBackEventReference(PostBackOptions, Boolean) method calls the RegisterForEventValidation(String, String) method to register the event reference for validation with a unique control ID that represents the client control that is generating the event.

Siehe auch

GetPostBackEventReference(PostBackOptions, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird vom angegebenen PostBackOptions-Objekt definiert.The reference string is defined by the specified PostBackOptions object. Registriert den Ereignisverweis optional für die Validierung.Optionally, registers the event reference for validation.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options, bool registerForEventValidation);
public string GetPostBackEventReference (System.Web.UI.PostBackOptions options, bool registerForEventValidation);
member this.GetPostBackEventReference : System.Web.UI.PostBackOptions * bool -> string
Public Function GetPostBackEventReference (options As PostBackOptions, registerForEventValidation As Boolean) As String

Parameter

options
PostBackOptions

Eine Instanz von PostBackOptions, die das Postback definiert.A PostBackOptions that defines the postback.

registerForEventValidation
Boolean

true, um den Ereignisverweis für die Validierung zu registrieren, andernfalls false.true to register the event reference for validation; otherwise, false.

Gibt zurück

Eine Zeichenfolge, die das Clientpostback initiiert, wenn sie auf dem Client als Skript behandelt wird.A string that, when treated as script on the client, initiates the client postback.

Ausnahmen

Hinweise

Verwenden Sie die IPostBackEventHandler -Anweisung, Page um die-Schnittstelle für ein-Objekt zu implementieren.To implement the IPostBackEventHandler interface for a Page object, use the directive.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet UseSubmitBehavior werden, falsewenn die-Eigenschaft ist.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Client Postback-Ereignis für Button das-Steuerelement zurück.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Wenn registerForEventValidation GetPostBackEventReference(PostBackOptions, Boolean) ist true, ruft die-Methode die- Methodeauf,umdenEreignisVerweisfürdieValidierungmiteinereindeutigenSteuerelement-IDzuregistrieren,diedasClientSteuerelementdarstellt,dasRegisterForEventValidation(String, String) das Ereignis erzeugt.If registerForEventValidation is true, the GetPostBackEventReference(PostBackOptions, Boolean) method calls the RegisterForEventValidation(String, String) method to register the event reference for validation with a unique control ID that represents the client control that is generating the event.

Siehe auch

GetPostBackEventReference(PostBackOptions)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird von der angegebenen PostBackOptions-Instanz definiert.The reference string is defined by the specified PostBackOptions instance.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options);
public string GetPostBackEventReference (System.Web.UI.PostBackOptions options);
member this.GetPostBackEventReference : System.Web.UI.PostBackOptions -> string
Public Function GetPostBackEventReference (options As PostBackOptions) As String

Parameter

options
PostBackOptions

Eine Instanz von PostBackOptions, die das Postback definiert.A PostBackOptions that defines the postback.

Gibt zurück

Eine Zeichenfolge, die das Clientpostback initiiert, wenn sie auf dem Client als Skript behandelt wird.A string that, when treated as script on the client, initiates the client postback.

Ausnahmen

Der PostBackOptions-Parameter ist null.The PostBackOptions parameter is null

Hinweise

Verwenden Sie die IPostBackEventHandler -Direktive Page, um die-Schnittstelle für zu implementieren.To implement the IPostBackEventHandler interface for a Page, use the directive.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet UseSubmitBehavior werden, falsewenn die-Eigenschaft ist.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Client Postback-Ereignis für Button das-Steuerelement zurück.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Siehe auch

GetPostBackEventReference(Control, String)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.Returns a string that can be used in a client event to cause postback to the server. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument);
public string GetPostBackEventReference (System.Web.UI.Control control, string argument);
member this.GetPostBackEventReference : System.Web.UI.Control * string -> string

Parameter

control
Control

Das Server-Control, das das Postback auf dem Server verarbeitet.The server Control that processes the postback on the server.

argument
String

Eine Zeichenfolge optionaler Argumente, die an das Steuerelement übergeben werden soll, das das Postback verarbeitet.A string of optional arguments to pass to the control that processes the postback.

Gibt zurück

Eine Zeichenfolge, die das Postback initiiert, wenn sie auf dem Client als Skript behandelt wird.A string that, when treated as script on the client, initiates the postback.

Ausnahmen

Der angegebene Control ist gleich null.The specified Control is null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung GetPostBackEventReference der-Methode veranschaulicht.The following code example demonstrates the use of the GetPostBackEventReference method. Das benutzerdefinierte Steuer MyControlElement implementiert die IPostBackEventHandler -Schnittstelle.The custom control, MyControl, implements the IPostBackEventHandler interface. Wenn auf die Schaltfläche auf der Seite geklickt wird RaisePostBackEvent , wird die-Methode des benutzerdefinierten Steuer Elements aufgerufen.When the button on the page is clicked, the RaisePostBackEvent method of the custom control is invoked.

<%@ Page Language="C#"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  public class MyControl : Label, IPostBackEventHandler
  {

    // Use the constructor to defined default label text.
    public MyControl()
    {
      base.Text = "No postback raised.";
    }
    
    // Implement the RaisePostBackEvent method from the
    // IPostBackEventHandler interface. 
    public void RaisePostBackEvent(string eventArgument)
    {
      base.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + ".";
      
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Create an instance of the custom label control and 
    // add it to the page.
    MyControl mycontrol = new MyControl();
    mycontrol.ID = "mycontrol1";
    PlaceHolder1.Controls.Add(mycontrol);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(mycontrol, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(mycontrol, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Public Class MyControl
    Inherits Label
    Implements IPostBackEventHandler
     
    Public Sub New()
      
      MyBase.Text = "No postback raised."
    
    End Sub
    
    Public Sub RaisePostBackEvent(ByVal eventArgument As String) Implements System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
      
      MyBase.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
                "Postback caused by " + eventArgument.ToString() & "."

    End Sub
    
  End Class
   

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript

    ' Create an instance of the custom label control and 
    ' add it to the page.
    Dim mycontrol As New MyControl()
    MyControl.ID = "mycontrol1"
    PlaceHolder1.Controls.Add(MyControl)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(MyControl, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(MyControl, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

Das folgende Codebeispiel verfügt über die gleiche Funktionalität wie die vorherige, mit dem Unterschied, dass die Page -Klasse anstelle eines benutzerdefinierten Steuer Elements die IPostBackEventHandler -Schnittstelle implementiert.The following code example has the same functionality as the preceding one, except that instead of a custom control, the Page class implements the IPostBackEventHandler interface.

<%@ Page Language="C#"  %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  public void RaisePostBackEvent(string eventArgument)
  {
    Label1.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + "."; ;
  }
  
  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(this, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(this, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
  Public Sub RaisePostBackEvent(ByVal eventArgument As String) _
    Implements IPostBackEventHandler.RaisePostBackEvent
    
    Label1.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
           "Postback caused by " + eventArgument.ToString() & "."
  
  End Sub
  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(Me, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(Me, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

Hinweise

Verwenden Sie die IPostBackEventHandler -Direktive Page, um die-Schnittstelle für zu implementieren.To implement the IPostBackEventHandler interface for a Page, use the directive.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet UseSubmitBehavior werden, falsewenn die-Eigenschaft ist.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Client Postback-Ereignis für Button das-Steuerelement zurück.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Siehe auch

Gilt für: