PostBackOptions Classe

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Especifica como o JavaScript do lado 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 seguinte utiliza o OnClick evento de um Button controlo para gerar um script do lado do cliente para um HyperLink controlo que permitirá ao HyperLink controlo causar um evento de postback. Como a ActionUrl propriedade do myPostBackOptions objeto está definida como "Page2.aspx", o postback irá publicar a página Web Forms noutra página chamada "Page2.aspx", que não é apresentada aqui. Para usar este exemplo, deve adicionar outra página 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 seguinte é uma página Web que pode ser usada para executar o ficheiro 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>

Observações

A PostBackOptions classe permite que os controlos emitam um script do lado do cliente que inicia um evento de postback. A PostBackOptions classe também fornece uma referência ao controlo que iniciou o evento de postback através 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 retorno ao servidor é iniciado por elementos como um botão Enviar ou um botão Imagem. No entanto, ao emitir JavaScript do lado do cliente, diferentes controlos podem iniciar um evento de postback.

Construtores

Name Description
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Inicializa uma nova instância da PostBackOptions classe com os valores especificados para as propriedades da instância.
PostBackOptions(Control, String)

Inicializa uma nova instância da PostBackOptions classe com os dados de controlo e argumento do alvo especificados.
PostBackOptions(Control)

Inicializa uma nova instância da PostBackOptions classe com os dados de controlo do alvo especificados.

Propriedades

Name Description
ActionUrl

Obtém ou define o URL alvo para o devolução de postagem de uma página de Web Forms.
Argument

Recebe ou define um argumento opcional que é transferido no evento de postback.
AutoPostBack

Recebe ou define um valor que indica se o formulário será automaticamente publicado de volta ao servidor em resposta a uma ação do utilizador.
ClientSubmit

Recebe ou define um valor que indica se o evento de postback deve ocorrer a partir do script do lado do cliente.
PerformValidation

Recebe ou define um valor que indica se é necessária validação do lado do cliente antes de ocorrer o evento de postback.
RequiresJavaScriptProtocol

Recebe ou define um valor que indica se o javascript: prefixo é gerado para o script do lado do cliente.
TargetControl

Obtém o alvo de controlo que recebe o evento de postback.
TrackFocus

Recebe ou define um valor que indica se o evento de postback deve devolver a página à posição atual do scroll e devolver o foco ao controlo atual.
ValidationGroup

Obtém ou define o grupo de controlos para os quais o PostBackOptions objeto causa validação quando é enviado de volta ao servidor.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também