ClientScriptManager.GetPostBackEventReference Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann.

Ü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. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen. Registriert den Ereignisverweis optional für die Validierung.
GetPostBackEventReference(PostBackOptions, Boolean)	Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird vom angegebenen PostBackOptions-Objekt definiert. Registriert den Ereignisverweis optional für die Validierung.
GetPostBackEventReference(PostBackOptions)	Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird von der angegebenen PostBackOptions-Instanz definiert.
GetPostBackEventReference(Control, String)	Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.

GetPostBackEventReference(Control, String, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen. Registriert den Ereignisverweis optional für die Validierung.

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

Public Function GetPostBackEventReference (control As Control, argument As String, registerForEventValidation As Boolean) As String

Parameter

control

Control

Das Server-Control, das das Postback auf dem Server verarbeitet.

argument

String

Eine Zeichenfolge optionaler Argumente, die an control übergeben werden sollen.

registerForEventValidation

Boolean

true, um den Ereignisverweis für die Validierung zu registrieren, andernfalls false.

Gibt zurück

String

Eine Zeichenfolge, die das Postback initiiert, wenn sie auf dem Client als Skript behandelt wird.

Ausnahmen

ArgumentNullException

Der angegebene Control ist gleich null.

Hinweise

Verwenden Sie @ Implements die -Anweisung, um die IPostBackEventHandler -Schnittstelle für eine Pagezu implementieren.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet werden, wenn die UseSubmitBehavior -Eigenschaft ist false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Clientpostbackereignis für das Button Steuerelement zurück.

Wenn registerForEventValidation true ist, ruft die GetPostBackEventReference(PostBackOptions, Boolean) -Methode die RegisterForEventValidation(String, String) -Methode auf, um den Ereignisverweis für die Validierung mit einer eindeutigen Steuerelement-ID zu registrieren, die das Clientsteuerelement darstellt, das das Ereignis generiert.

Weitere Informationen

• PostBackOptions
• IPostBackEventHandler
• Clientrückrufe ohne Postbacks in ASP.NET Pages

GetPostBackEventReference(PostBackOptions, Boolean)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird vom angegebenen PostBackOptions-Objekt definiert. Registriert den Ereignisverweis optional für die Validierung.

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.

registerForEventValidation

Boolean

true, um den Ereignisverweis für die Validierung zu registrieren, andernfalls false.

Gibt zurück

String

Eine Zeichenfolge, die das Clientpostback initiiert, wenn sie auf dem Client als Skript behandelt wird.

Ausnahmen

ArgumentNullException

Der Jointyp (PostBackOptions) lautet null.

Hinweise

Verwenden Sie die -Direktive, um die IPostBackEventHandler@ Implements -Schnittstelle für ein Page -Objekt zu implementieren.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet werden, wenn die UseSubmitBehavior -Eigenschaft ist false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Clientpostbackereignis für das Button Steuerelement zurück.

Wenn registerForEventValidation ist true, ruft die GetPostBackEventReference(PostBackOptions, Boolean) -Methode die RegisterForEventValidation(String, String) -Methode auf, um den Ereignisverweis für die Validierung mit einer eindeutigen Steuerelement-ID zu registrieren, die das Clientsteuerelement darstellt, das das Ereignis generiert.

Weitere Informationen

• PostBackOptions
• IPostBackEventHandler
• Button
• Clientrückrufe ohne Postbacks in ASP.NET Pages

GetPostBackEventReference(PostBackOptions)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird von der angegebenen PostBackOptions-Instanz definiert.

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.

Gibt zurück

String

Eine Zeichenfolge, die das Clientpostback initiiert, wenn sie auf dem Client als Skript behandelt wird.

Ausnahmen

ArgumentNullException

Der PostBackOptions-Parameter ist null.

Hinweise

Verwenden Sie @ Implements die -Anweisung, um die IPostBackEventHandler -Schnittstelle für eine Pagezu implementieren.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet werden, wenn die UseSubmitBehavior -Eigenschaft ist false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Clientpostbackereignis für das Button Steuerelement zurück.

Weitere Informationen

• PostBackOptions
• IPostBackEventHandler
• Button
• Clientrückrufe ohne Postbacks in ASP.NET Pages

GetPostBackEventReference(Control, String)

Gibt eine Zeichenfolge zurück, die in einem Clientereignis zum Auslösen eines Postbacks an den Server verwendet werden kann. Die Verweiszeichenfolge wird durch das angegebene Steuerelement definiert, das das Postback behandelt, und einem Zeichenfolgenargument mit weiteren Ereignisinformationen.

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

Public Function GetPostBackEventReference (control As Control, argument As String) As String

Parameter

control

Control

Das Server-Control, das das Postback auf dem Server verarbeitet.

argument

String

Eine Zeichenfolge optionaler Argumente, die an das Steuerelement übergeben werden soll, das das Postback verarbeitet.

Gibt zurück

String

Eine Zeichenfolge, die das Postback initiiert, wenn sie auf dem Client als Skript behandelt wird.

Ausnahmen

ArgumentNullException

Der angegebene Control ist gleich null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetPostBackEventReference -Methode veranschaulicht. Das benutzerdefinierte Steuerelement MyControlimplementiert die IPostBackEventHandler -Schnittstelle. Wenn auf die Schaltfläche auf der Seite geklickt wird, wird die RaisePostBackEvent -Methode des benutzerdefinierten Steuerelements aufgerufen.

<%@ 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 das vorherige, mit dem Unterschied, dass die Page -Klasse anstelle eines benutzerdefinierten Steuerelements die IPostBackEventHandler -Schnittstelle implementiert.

<%@ 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 @ Implements die -Anweisung, um die IPostBackEventHandler -Schnittstelle für eine Pagezu implementieren.

Die GetPostBackEventReference -Methode kann mit dem Button -Steuerelement verwendet werden, wenn die UseSubmitBehavior -Eigenschaft ist false. In diesem Szenario gibt die GetPostBackEventReference -Methode das Clientpostbackereignis für das Button Steuerelement zurück.

Weitere Informationen

• PostBackOptions
• IPostBackEventHandler
• Clientrückrufe ohne Postbacks in ASP.NET Pages