PostBackOptions Classe

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica como o JavaScript do cliente é gerado para iniciar um evento de postback.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Herança: Object
PostBackOptions

Exemplos

O exemplo de código a seguir usa o OnClick evento de um Button controle para gerar script do lado do cliente para um HyperLink controle que permitirá que o HyperLink controle cause um evento de postback. Como a ActionUrl propriedade do myPostBackOptions objeto está definida como "Page2.aspx", o postback postará a página Web Forms em outra página chamada "Page2.aspx", que não é fornecida aqui. Para usar este exemplo, você deve adicionar outra página da Web chamada "Page2.aspx" ao seu projeto ou diretório.

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

O exemplo de código a seguir é uma página da Web que pode ser usada para executar o arquivo code-behind 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>

Comentários

A PostBackOptions classe permite que os controles emitam o script do lado do cliente que inicia um evento de postback. A PostBackOptions classe também fornece uma referência ao controle que iniciou o evento de postback por meio da TargetControl propriedade. O evento de postback é criado com base nas opções especificadas no PostBackOptions objeto passado para o ClientScriptManager.GetPostBackEventReference método.

Normalmente, um postback no servidor é iniciado por elementos como um botão Enviar ou um botão Imagem. No entanto, ao emitir JavaScript do lado do cliente, controles diferentes podem iniciar um evento de postback.

Construtores

PostBackOptions(Control)	Inicializa uma nova instância da classe PostBackOptions com os dados de controle de destino especificados.
PostBackOptions(Control, String)	Inicializa uma nova instância da classe PostBackOptions com os dados de argumento e controle de destino especificados.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicializa uma nova instância da classe PostBackOptions com os valores especificados para as propriedades da instância.

Propriedades

ActionUrl	Obtém ou define a URL de destino para o postback de uma página do Web Forms.
Argument	Obtém ou define um argumento opcional que é transferido no evento de postback.
AutoPostBack	Obtém ou define um valor que indica se o formulário postará automaticamente de volta para o servidor em resposta a uma ação do usuário.
ClientSubmit	Obtém ou define um valor que indica se o evento de postback deve ocorrer de script do lado do cliente.
PerformValidation	Obtém ou define um valor que indica se a validação do lado do cliente é necessária antes que o evento de postback ocorra.
RequiresJavaScriptProtocol	Obtém ou define um valor que indica se o prefixo `javascript:` é gerado para o script do lado do cliente.
TargetControl	Obtém o destino de controle que recebe o evento de postback.
TrackFocus	Obtém ou define um valor que indica se o evento de postback deve retornar a página para a posição de rolagem atual e retornar o foco para o controle atual.
ValidationGroup	Obtém ou define o grupo de controles para o qual o objeto PostBackOptions causa a validação quando ele executa um postback para o servidor.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

GetPostBackEventReference(PostBackOptions)