ClientScriptManager.GetPostBackEventReference Metodo

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server.

Overload

Nome	Descrizione
GetPostBackEventReference(Control, String, Boolean)	Restituisce una stringa da utilizzare in un evento client per causare il postback al server. La stringa di riferimento è definita dal controllo specificato che gestisce il postback e un argomento stringa di informazioni aggiuntive sull'evento. Facoltativamente, registra il riferimento all'evento per la convalida.
GetPostBackEventReference(PostBackOptions, Boolean)	Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dall'oggetto specificato PostBackOptions . Facoltativamente, registra il riferimento all'evento per la convalida.
GetPostBackEventReference(PostBackOptions)	Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dall'istanza specificata PostBackOptions .
GetPostBackEventReference(Control, String)	Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dal controllo specificato che gestisce il postback e un argomento stringa di informazioni aggiuntive sull'evento.

GetPostBackEventReference(Control, String, Boolean)

Restituisce una stringa da utilizzare in un evento client per causare il postback al server. La stringa di riferimento è definita dal controllo specificato che gestisce il postback e un argomento stringa di informazioni aggiuntive sull'evento. Facoltativamente, registra il riferimento all'evento per la convalida.

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

Parametri

control: Control

Control Server che elabora il postback nel server.

argument: String

Stringa di argomenti facoltativi da passare a control.

registerForEventValidation: Boolean

true per registrare il riferimento all'evento per la convalida; in caso contrario, false.

Restituisce

String

Stringa che, se considerata come script nel client, avvia il postback.

Eccezioni

ArgumentNullException

L'oggetto specificato Control è null.

Commenti

Per implementare l'interfaccia IPostBackEventHandler per un Pageoggetto , usare la @ Implements direttiva .

Il GetPostBackEventReference metodo può essere utilizzato con il Button controllo quando la UseSubmitBehavior proprietà è false. In questo scenario, il GetPostBackEventReference metodo restituisce l'evento di postback client per il Button controllo .

Se registerForEventValidation è true, il metodo chiama il GetPostBackEventReference(PostBackOptions, Boolean) metodo per registrare il RegisterForEventValidation(String, String) riferimento all'evento per la convalida con un ID di controllo univoco che rappresenta il controllo client che genera l'evento.

Vedi anche

Si applica a

GetPostBackEventReference(PostBackOptions, Boolean)

Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dall'oggetto specificato PostBackOptions . Facoltativamente, registra il riferimento all'evento per la convalida.

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

Parametri

options: PostBackOptions

Oggetto PostBackOptions che definisce il postback.

registerForEventValidation: Boolean

true per registrare il riferimento all'evento per la convalida; in caso contrario, false.

Restituisce

String

Stringa che, se considerata come script nel client, avvia il postback del client.

Eccezioni

ArgumentNullException

Il PostBackOptions è null.

Commenti

Per implementare l'interfaccia IPostBackEventHandler per un Page oggetto, usare la @ Implements direttiva .

Se registerForEventValidation è true, il GetPostBackEventReference(PostBackOptions, Boolean) metodo chiama il metodo per registrare il RegisterForEventValidation(String, String) riferimento all'evento per la convalida con un ID di controllo univoco che rappresenta il controllo client che genera l'evento.

Vedi anche

Si applica a

GetPostBackEventReference(PostBackOptions)

Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dall'istanza specificata PostBackOptions .

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

Parametri

options: PostBackOptions

Oggetto PostBackOptions che definisce il postback.

Restituisce

String

Stringa che, se considerata come script nel client, avvia il postback del client.

Eccezioni

ArgumentNullException

Il PostBackOptions parametro è null

Commenti

Per implementare l'interfaccia IPostBackEventHandler per un Pageoggetto , usare la @ Implements direttiva .

Vedi anche

Si applica a

GetPostBackEventReference(Control, String)

Restituisce una stringa che può essere utilizzata in un evento client per causare il postback al server. La stringa di riferimento è definita dal controllo specificato che gestisce il postback e un argomento stringa di informazioni aggiuntive sull'evento.

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

Parametri

control: Control

Control Server che elabora il postback nel server.

argument: String

Stringa di argomenti facoltativi da passare al controllo che elabora il postback.

Restituisce

String

Stringa che, se considerata come script nel client, avvia il postback.

Eccezioni

ArgumentNullException

L'oggetto specificato Control è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del GetPostBackEventReference metodo . Il controllo personalizzato, MyControl, implementa l'interfaccia IPostBackEventHandler . Quando si fa clic sul pulsante nella pagina, viene richiamato il RaisePostBackEvent metodo del controllo personalizzato.

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

L'esempio di codice seguente ha la stessa funzionalità di quella precedente, ad eccezione del fatto che invece di un controllo personalizzato, la Page classe implementa l'interfaccia IPostBackEventHandler .

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

Commenti

Per implementare l'interfaccia IPostBackEventHandler per un Pageoggetto , usare la @ Implements direttiva .

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

ClientScriptManager.GetPostBackEventReference Metodo

Definizione

Overload

GetPostBackEventReference(Control, String, Boolean)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

GetPostBackEventReference(PostBackOptions, Boolean)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

GetPostBackEventReference(PostBackOptions)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

GetPostBackEventReference(Control, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti