ClientScriptManager.GetPostBackEventReference Método

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor.

Sobrecargas

Nombre	Description
GetPostBackEventReference(Control, String, Boolean)	Devuelve una cadena que se va a usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el control especificado que controla el postback y un argumento de cadena de información adicional del evento. Opcionalmente, registra la referencia de eventos para la validación.
GetPostBackEventReference(PostBackOptions, Boolean)	Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el objeto especificado PostBackOptions . Opcionalmente, registra la referencia de eventos para la validación.
GetPostBackEventReference(PostBackOptions)	Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante la instancia especificada PostBackOptions .
GetPostBackEventReference(Control, String)	Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el control especificado que controla el postback y un argumento de cadena de información adicional del evento.

GetPostBackEventReference(Control, String, Boolean)

Devuelve una cadena que se va a usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el control especificado que controla el postback y un argumento de cadena de información adicional del evento. Opcionalmente, registra la referencia de eventos para la validación.

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

Parámetros

control: Control

Control Servidor que procesa el postback en el servidor.

argument: String

Cadena de argumentos opcionales que se van a pasar a control.

registerForEventValidation: Boolean

true para registrar la referencia de eventos para la validación; de lo contrario, false.

Devoluciones

String

Cadena que, cuando se trata como script en el cliente, inicia el postback.

Excepciones

ArgumentNullException

El especificado Control es null.

Comentarios

Para implementar la IPostBackEventHandler interfaz para , Pageuse la @ Implements directiva .

El GetPostBackEventReference método se puede usar con el Button control cuando la UseSubmitBehavior propiedad es false. En este escenario, el GetPostBackEventReference método devuelve el evento postback del cliente para el Button control .

Si registerForEventValidation es true, el GetPostBackEventReference(PostBackOptions, Boolean) método llama al RegisterForEventValidation(String, String) método para registrar la referencia de evento para la validación con un identificador de control único que representa el control de cliente que genera el evento.

Consulte también

Se aplica a

GetPostBackEventReference(PostBackOptions, Boolean)

Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el objeto especificado PostBackOptions . Opcionalmente, registra la referencia de eventos para la validación.

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

Parámetros

options: PostBackOptions

que PostBackOptions define el postback.

registerForEventValidation: Boolean

true para registrar la referencia de eventos para la validación; de lo contrario, false.

Devoluciones

String

Cadena que, cuando se trata como script en el cliente, inicia el postback del cliente.

Excepciones

ArgumentNullException

El valor de PostBackOptions es null.

Comentarios

Para implementar la IPostBackEventHandler interfaz de un Page objeto, use la @ Implements directiva .

Si registerForEventValidation es true, el GetPostBackEventReference(PostBackOptions, Boolean) método llama al RegisterForEventValidation(String, String) método para registrar la referencia de evento para la validación con un identificador de control único que representa el control de cliente que genera el evento.

Consulte también

Se aplica a

GetPostBackEventReference(PostBackOptions)

Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante la instancia especificada 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

Parámetros

options: PostBackOptions

que PostBackOptions define el postback.

Devoluciones

String

Cadena que, cuando se trata como script en el cliente, inicia el postback del cliente.

Excepciones

ArgumentNullException

El PostBackOptions parámetro es null

Comentarios

Para implementar la IPostBackEventHandler interfaz para , Pageuse la @ Implements directiva .

Consulte también

Se aplica a

GetPostBackEventReference(Control, String)

Devuelve una cadena que se puede usar en un evento de cliente para provocar la devolución de entrada al servidor. La cadena de referencia se define mediante el control especificado que controla el postback y un argumento de cadena de información adicional del 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

Parámetros

control: Control

Control Servidor que procesa el postback en el servidor.

argument: String

Cadena de argumentos opcionales que se van a pasar al control que procesa el postback.

Devoluciones

String

Cadena que, cuando se trata como script en el cliente, inicia el postback.

Excepciones

ArgumentNullException

El especificado Control es null.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del GetPostBackEventReference método . El control personalizado, MyControl, implementa la IPostBackEventHandler interfaz . Cuando se hace clic en el botón de la página, se invoca el RaisePostBackEvent método del control personalizado.

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

El ejemplo de código siguiente tiene la misma funcionalidad que la anterior, excepto que, en lugar de un control personalizado, la Page clase implementa la IPostBackEventHandler interfaz .

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

Comentarios

Para implementar la IPostBackEventHandler interfaz para , Pageuse la @ Implements directiva .

Consulte también

Se aplica a

Comentarios

Resultoulle útil esta páxina?

Compartir por

ClientScriptManager.GetPostBackEventReference Método

Definición

Sobrecargas

GetPostBackEventReference(Control, String, Boolean)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

GetPostBackEventReference(PostBackOptions, Boolean)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

GetPostBackEventReference(PostBackOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

GetPostBackEventReference(Control, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios