ClientScriptManager.GetPostBackEventReference Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server.

Přetížení

GetPostBackEventReference(Control, String, Boolean)	Vrátí řetězec, který se má použít v události klienta, aby způsobil postback na server. Referenční řetězec je definován zadaným ovládacím prvku, který zpracovává postback a řetězcový argument dalších informací o událostech. Volitelně zaregistruje odkaz na událost pro ověření.
GetPostBackEventReference(PostBackOptions, Boolean)	Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadaným PostBackOptions objektem. Volitelně zaregistruje odkaz na událost pro ověření.
GetPostBackEventReference(PostBackOptions)	Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadanou PostBackOptions instancí.
GetPostBackEventReference(Control, String)	Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadaným ovládacím prvku, který zpracovává postback a řetězcový argument dalších informací o událostech.

GetPostBackEventReference(Control, String, Boolean)

Vrátí řetězec, který se má použít v události klienta, aby způsobil postback na server. Referenční řetězec je definován zadaným ovládacím prvku, který zpracovává postback a řetězcový argument dalších informací o událostech. Volitelně zaregistruje odkaz na událost pro ověření.

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

Parametry

control: Control

Server Control , který zpracovává postback na serveru.

argument: String

Řetězec volitelných argumentů, které se mají předat do control.

registerForEventValidation: Boolean

truek registraci odkazu na událost pro ověření; v opačném případě . false

Návraty

String

Řetězec, který je považován za skript v klientovi, inicializuje postback.

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

Poznámky

Pokud chcete implementovat IPostBackEventHandler rozhraní pro Page, použijte direktivu @ Implements .

Metodu GetPostBackEventReference lze použít s ovládacím prvku, Button když UseSubmitBehavior je falsevlastnost . V tomto scénáři GetPostBackEventReference metoda vrátí událost postback klienta pro Button ovládací prvek.

Pokud registerForEventValidation je hodnota true, GetPostBackEventReference(PostBackOptions, Boolean) metoda volá metodu RegisterForEventValidation(String, String) pro registraci odkazu na událost pro ověření s jedinečným ID ovládacího prvku, které představuje ovládací prvek klienta, který generuje událost.

Viz také

Platí pro

GetPostBackEventReference(PostBackOptions, Boolean)

Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadaným PostBackOptions objektem. Volitelně zaregistruje odkaz na událost pro ověření.

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

Parametry

options: PostBackOptions

A PostBackOptions , který definuje postback.

registerForEventValidation: Boolean

truek registraci odkazu na událost pro ověření; v opačném případě . false

Návraty

String

Řetězec, který je v klientovi považován za skript, zahájí postback klienta.

Výjimky

ArgumentNullException

Hodnota PostBackOptions je null.

Poznámky

K implementaci IPostBackEventHandler rozhraní pro Page objekt použijte direktivu @ Implements .

Pokud registerForEventValidation je true, GetPostBackEventReference(PostBackOptions, Boolean) metoda volá metodu RegisterForEventValidation(String, String) pro registraci odkazu na událost pro ověření s jedinečným ID ovládacího prvku, které představuje ovládací prvek klienta, který generuje událost.

Viz také

Platí pro

GetPostBackEventReference(PostBackOptions)

Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadanou PostBackOptions instancí.

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

Parametry

options: PostBackOptions

A PostBackOptions , který definuje postback.

Návraty

String

Řetězec, který je v klientovi považován za skript, zahájí postback klienta.

Výjimky

ArgumentNullException

Parametr PostBackOptions je null

Poznámky

Pokud chcete implementovat IPostBackEventHandler rozhraní pro Page, použijte direktivu @ Implements .

Viz také

Platí pro

GetPostBackEventReference(Control, String)

Vrátí řetězec, který lze použít v události klienta k vyvolání zpětného odeslání na server. Referenční řetězec je definován zadaným ovládacím prvku, který zpracovává postback a řetězcový argument dalších informací o událostech.

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

Parametry

control: Control

Server Control , který zpracovává postback na serveru.

argument: String

Řetězec volitelných argumentů, které se mají předat ovládacímu prvku, který zpracovává postback.

Návraty

String

Řetězec, který je považován za skript v klientovi, inicializuje postback.

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

Příklady

Následující příklad kódu ukazuje použití GetPostBackEventReference metody. Vlastní ovládací prvek MyControlimplementuje IPostBackEventHandler rozhraní. Po kliknutí na tlačítko na stránce je vyvolána RaisePostBackEvent metoda vlastního ovládacího prvku.

<%@ 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>

Následující příklad kódu má stejné funkce jako předchozí s tím rozdílem, že místo vlastního ovládacího prvku Page třída implementuje IPostBackEventHandler rozhraní.

<%@ 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>

Poznámky

Pokud chcete implementovat IPostBackEventHandler rozhraní pro Page, použijte direktivu @ Implements .

Viz také

Platí pro

ClientScriptManager.GetPostBackEventReference Metoda

Definice

Přetížení

GetPostBackEventReference(Control, String, Boolean)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetPostBackEventReference(PostBackOptions, Boolean)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetPostBackEventReference(PostBackOptions)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetPostBackEventReference(Control, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Váš názor

Další materiály