ClientScriptManager.GetPostBackEventReference Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera.

Przeciążenia

GetPostBackEventReference(Control, String, Boolean)	Zwraca ciąg do użycia w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określoną kontrolkę, która obsługuje ogłaszanie zwrotne i argument ciągu dodatkowych informacji o zdarzeniu. Opcjonalnie rejestruje odwołanie do zdarzenia w celu weryfikacji.
GetPostBackEventReference(PostBackOptions, Boolean)	Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określony PostBackOptions obiekt. Opcjonalnie rejestruje odwołanie do zdarzenia w celu weryfikacji.
GetPostBackEventReference(PostBackOptions)	Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określone PostBackOptions wystąpienie.
GetPostBackEventReference(Control, String)	Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określoną kontrolkę, która obsługuje ogłaszanie zwrotne i argument ciągu dodatkowych informacji o zdarzeniu.

GetPostBackEventReference(Control, String, Boolean)

Zwraca ciąg do użycia w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określoną kontrolkę, która obsługuje ogłaszanie zwrotne i argument ciągu dodatkowych informacji o zdarzeniu. Opcjonalnie rejestruje odwołanie do zdarzenia w celu weryfikacji.

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

Serwer Control , który przetwarza ogłaszanie zwrotne na serwerze.

argument: String

Ciąg opcjonalnych argumentów do przekazania do elementu control.

registerForEventValidation: Boolean

true aby zarejestrować odwołanie do zdarzenia w celu weryfikacji; w przeciwnym razie , false.

Zwraca

String

Ciąg, który po traktowaniu jako skrypt na kliencie inicjuje ogłaszanie zwrotne.

Wyjątki

ArgumentNullException

Określony Control parametr to null.

Uwagi

Aby zaimplementować IPostBackEventHandler interfejs dla elementu Page, użyj @ Implements dyrektywy .

Metoda GetPostBackEventReference może być używana z kontrolką Button , gdy UseSubmitBehavior właściwość ma falsewartość . W tym scenariuszu GetPostBackEventReference metoda zwraca zdarzenie ogłaszania zwrotnego klienta dla kontrolki Button .

Jeśli registerForEventValidation ma wartość true, GetPostBackEventReference(PostBackOptions, Boolean) metoda wywołuje metodę RegisterForEventValidation(String, String) w celu zarejestrowania odwołania zdarzenia do weryfikacji za pomocą unikatowego identyfikatora kontrolki reprezentującego kontrolkę klienta generującą zdarzenie.

Zobacz też

Dotyczy

GetPostBackEventReference(PostBackOptions, Boolean)

Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określony PostBackOptions obiekt. Opcjonalnie rejestruje odwołanie do zdarzenia w celu weryfikacji.

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

Element PostBackOptions definiujący ogłaszanie zwrotne.

registerForEventValidation: Boolean

true aby zarejestrować odwołanie do zdarzenia w celu weryfikacji; w przeciwnym razie , false.

Zwraca

String

Ciąg, który po traktowaniu jako skrypt na kliencie inicjuje ogłaszanie zwrotne klienta.

Wyjątki

ArgumentNullException

Wartość PostBackOptions to null.

Uwagi

Aby zaimplementować IPostBackEventHandler interfejs dla Page obiektu, użyj @ Implements dyrektywy .

Jeśli registerForEventValidation parametr ma truewartość , GetPostBackEventReference(PostBackOptions, Boolean) metoda wywołuje metodę RegisterForEventValidation(String, String) w celu zarejestrowania odwołania zdarzenia do weryfikacji za pomocą unikatowego identyfikatora kontrolki reprezentującego kontrolkę klienta generującą zdarzenie.

Zobacz też

Dotyczy

GetPostBackEventReference(PostBackOptions)

Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określone PostBackOptions wystąpienie.

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

Element PostBackOptions definiujący ogłaszanie zwrotne.

Zwraca

String

Ciąg, który po traktowaniu jako skrypt na kliencie inicjuje ogłaszanie zwrotne klienta.

Wyjątki

ArgumentNullException

Parametr PostBackOptions to null

Uwagi

Aby zaimplementować IPostBackEventHandler interfejs dla elementu Page, użyj @ Implements dyrektywy .

Zobacz też

Dotyczy

GetPostBackEventReference(Control, String)

Zwraca ciąg, który może być używany w zdarzeniu klienta, aby spowodować powrót do serwera. Ciąg odwołania jest definiowany przez określoną kontrolkę, która obsługuje ogłaszanie zwrotne i argument ciągu dodatkowych informacji o zdarzeniu.

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

Serwer Control , który przetwarza ogłaszanie zwrotne na serwerze.

argument: String

Ciąg opcjonalnych argumentów do przekazania do kontrolki, która przetwarza ogłaszanie zwrotne.

Zwraca

String

Ciąg, który po traktowaniu jako skrypt na kliencie inicjuje ogłaszanie zwrotne.

Wyjątki

ArgumentNullException

Określony Control parametr to null.

Przykłady

W poniższym przykładzie kodu pokazano użycie GetPostBackEventReference metody . Kontrolka niestandardowa implementuje MyControlIPostBackEventHandler interfejs . Po kliknięciu RaisePostBackEvent przycisku na stronie wywoływana jest metoda kontrolki niestandardowej.

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

Poniższy przykład kodu ma taką samą funkcjonalność jak poprzedni, z tą różnicą, że zamiast niestandardowej kontrolki Page klasa implementuje IPostBackEventHandler interfejs.

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

Uwagi

Aby zaimplementować IPostBackEventHandler interfejs dla elementu Page, użyj @ Implements dyrektywy .

Zobacz też

Dotyczy

ClientScriptManager.GetPostBackEventReference Metoda

Definicja

Przeciążenia

GetPostBackEventReference(Control, String, Boolean)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

GetPostBackEventReference(PostBackOptions, Boolean)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

GetPostBackEventReference(PostBackOptions)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

GetPostBackEventReference(Control, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby