PostBackOptions Clase

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í.

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 control para generar un Button 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 se establece en "Page2.aspx", la devolución de entrada publicará la página de formularios web 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 siguiente ejemplo de código 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 un script del lado cliente que inicia un evento de postback. La PostBackOptions clase también proporciona una referencia al control que inició el evento postback a través de la TargetControl propiedad . El evento 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 lo inician elementos como un botón Enviar o un botón Imagen. Sin embargo, al emitir JavaScript del lado cliente, distintos controles pueden iniciar un evento de postback.

Constructores

Nombre	Description
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicializa una nueva instancia de la PostBackOptions clase con los valores especificados para las propiedades de la instancia.
PostBackOptions(Control, String)	Inicializa una nueva instancia de la PostBackOptions clase con los datos de argumento y control de destino especificados.
PostBackOptions(Control)	Inicializa una nueva instancia de la PostBackOptions clase con los datos de control de destino especificados.

Propiedades

Nombre	Description
ActionUrl	Obtiene o establece la dirección URL de destino de la devolución de una página de Formularios Web Forms.
Argument	Obtiene o establece un argumento opcional que se transfiere en el evento postback.
AutoPostBack	Obtiene o establece un valor que indica si el formulario volverá a publicarse automáticamente en el servidor en respuesta a una acción del usuario.
ClientSubmit	Obtiene o establece un valor que indica si el evento de postback debe producirse a partir del script del lado cliente.
PerformValidation	Obtiene o establece un valor que indica si se requiere la validación del lado cliente antes de que se produzca el evento postback.
RequiresJavaScriptProtocol	Obtiene o establece un valor que indica si el `javascript:` prefijo se genera para el script del lado cliente.
TargetControl	Obtiene el destino de control que recibe el evento postback.
TrackFocus	Obtiene o establece un valor que indica si el evento postback debe devolver la página a la posición de desplazamiento actual y devolver el foco al control actual.
ValidationGroup	Obtiene o establece el grupo de controles para los que el PostBackOptions objeto provoca la validación cuando envía de vuelta al servidor.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Consulte también

GetPostBackEventReference(PostBackOptions)

Comentarios

Resultoulle útil esta páxina?

Compartir por

PostBackOptions Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

Comentarios