PostBackOptions Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Especifica cómo se genera JavaScript del lado cliente para iniciar un evento de postback.

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
Herencia
Object
PostBackOptions

Ejemplos

En el ejemplo de código siguiente se usa el OnClick evento de un Button control para generar un script del lado cliente para un HyperLink control que permitirá que el HyperLink control cause un evento de postback. Dado que la ActionUrl propiedad del myPostBackOptions objeto está establecida en "Page2.aspx", el postback publicará la página de Web Forms en otra página denominada "Page2.aspx", que no se proporciona aquí. Para usar este ejemplo, debe agregar otra página web denominada "Page2.aspx" al proyecto o directorio.

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class postbackoptionscs : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (Page.IsPostBack)
        {
            Label1.Text = "A postback event has occurred.";
        }
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Create a new PostBackOptions object and set its properties.
        PostBackOptions myPostBackOptions = new PostBackOptions(this);
        myPostBackOptions.ActionUrl = "Page2.aspx";
        myPostBackOptions.AutoPostBack = false;
        myPostBackOptions.RequiresJavaScriptProtocol = true;
        myPostBackOptions.PerformValidation = true;

        // Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions);

        Label1.Text = "Click this hyperlink to initiate a postback event.";
    }
}

Partial Class postbackoptionsvb
    Inherits System.Web.UI.Page
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

        ' Create a new PostBackOptions object and set its properties.
        Dim myPostBackOptions As PostBackOptions = New PostBackOptions(Me)
        myPostBackOptions.ActionUrl = "Page2.aspx"
        myPostBackOptions.AutoPostBack = False
        myPostBackOptions.RequiresJavaScriptProtocol = True
        myPostBackOptions.PerformValidation = True

        ' Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions)

        Label1.Text = "Click this hyperlink to initiate a postback event."

    End Sub

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load

        If Page.IsPostBack Then
            Label1.Text = "A postback event has occurred."
        End If

    End Sub
End Class

El ejemplo de código siguiente es una página web que se puede usar para ejecutar el archivo de código subyacente anterior.

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="postbackoptions.aspx.cs" Inherits="postbackoptionscs" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text="">
      </asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback">
      </asp:HyperLink>
    </form>
  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="true" CodeFile="postbackoptions.aspx.vb" Inherits="postbackoptionsvb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text=""></asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback"></asp:HyperLink>
      <br />
    </form>
  </body>
</html>

Comentarios

La PostBackOptions clase permite a los controles emitir script del lado cliente que inicia un evento de postback. La PostBackOptions clase también proporciona una referencia al control que inició el evento de postback a través de la TargetControl propiedad . El evento de postback se crea en función de las opciones especificadas en el PostBackOptions objeto pasado al ClientScriptManager.GetPostBackEventReference método .

Normalmente, un postback en el servidor se inicia mediante elementos como un botón Enviar o un botón Imagen. Sin embargo, al emitir JavaScript del lado cliente, los distintos controles pueden iniciar un evento de postback.

Constructores

PostBackOptions(Control)

Inicializa una nueva instancia de la clase PostBackOptions con los datos de control de destino especificados.
PostBackOptions(Control, String)

Inicializa una nueva instancia de la clase PostBackOptions con los datos de control de destino y el argumento especificados.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Inicializa una nueva instancia de la clase PostBackOptions con los valores especificados de las propiedades de la instancia.

Propiedades

ActionUrl

Obtiene o establece la dirección URL de destino para el postback de una página de formularios Web Forms.
Argument

Obtiene o establece un argumento opcional que se transfiere en el evento de postback.
AutoPostBack

Obtiene o establece un valor que indica si el formulario devolverá los datos automáticamente al servidor como respuesta a una acción del usuario.
ClientSubmit

Obtiene o establece un valor que indica si el evento de postback se debe producir a partir del script de cliente.
PerformValidation

Obtiene o establece un valor que indica si es necesaria la validación del lado cliente antes de que se produzca el evento de postback.
RequiresJavaScriptProtocol

Obtiene o establece un valor que indica si se genera el prefijo javascript: para el script de cliente.
TargetControl

Obtiene el control de destino que recibe el evento de postback.
TrackFocus

Obtiene o establece un valor que indica si el evento de postback debe volver a poner la página en la posición de desplazamiento actual y devolver el foco al control actual.
ValidationGroup

Obtiene o establece el grupo de controles cuya validación es generada por el objeto PostBackOptions cuando éste se devuelve al servidor.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también