PostBackOptions Classe

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica il modo in cui viene generato JavaScript sul lato client per avviare un evento di postback.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Ereditarietà: Object
PostBackOptions

Esempio

Nell'esempio di codice seguente viene utilizzato l'evento OnClick di un Button controllo per generare uno script lato client per un HyperLink controllo che consentirà al HyperLink controllo di generare un evento di postback. Poiché la ActionUrl proprietà dell'oggetto myPostBackOptions è impostata su "Page2.aspx", il postback pubblicherà la pagina Web Form in un'altra pagina denominata "Page2.aspx", che non viene fornita qui. Per usare questo esempio, è necessario aggiungere un'altra pagina Web denominata "Page2.aspx" al progetto o alla directory.

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

L'esempio di codice seguente è una pagina Web che può essere usata per eseguire il file code-behind precedente.

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

Commenti

La PostBackOptions classe consente ai controlli di generare uno script sul lato client che avvia un evento di postback. La PostBackOptions classe fornisce anche un riferimento al controllo che ha avviato l'evento di postback tramite la TargetControl proprietà . L'evento di postback viene creato in base alle opzioni specificate nell'oggetto PostBackOptions passato al ClientScriptManager.GetPostBackEventReference metodo .

In genere, un postback al server viene avviato da elementi come un pulsante Invia o un pulsante Immagine. Tuttavia, creando JavaScript sul lato client, controlli diversi possono avviare un evento di postback.

Costruttori

Nome	Descrizione
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inizializza una nuova istanza della PostBackOptions classe con i valori specificati per le proprietà dell'istanza.
PostBackOptions(Control, String)	Inizializza una nuova istanza della PostBackOptions classe con il controllo di destinazione e i dati dell'argomento specificati.
PostBackOptions(Control)	Inizializza una nuova istanza della PostBackOptions classe con i dati del controllo di destinazione specificati.

Proprietà

Nome	Descrizione
ActionUrl	Ottiene o imposta l'URL di destinazione per il postback di una pagina Web Form.
Argument	Ottiene o imposta un argomento facoltativo trasferito nell'evento di postback.
AutoPostBack	Ottiene o imposta un valore che indica se il modulo eseguirà automaticamente il postback al server in risposta a un'azione dell'utente.
ClientSubmit	Ottiene o imposta un valore che indica se l'evento di postback deve verificarsi dallo script sul lato client.
PerformValidation	Ottiene o imposta un valore che indica se la convalida lato client è necessaria prima che si verifichi l'evento di postback.
RequiresJavaScriptProtocol	Ottiene o imposta un valore che indica se il `javascript:` prefisso viene generato per lo script sul lato client.
TargetControl	Ottiene la destinazione del controllo che riceve l'evento di postback.
TrackFocus	Ottiene o imposta un valore che indica se l'evento di postback deve restituire la pagina alla posizione di scorrimento corrente e restituire lo stato attivo al controllo corrente.
ValidationGroup	Ottiene o imposta il gruppo di controlli per cui l'oggetto PostBackOptions causa la convalida quando esegue il postback al server.

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Vedi anche

GetPostBackEventReference(PostBackOptions)

Commenti e suggerimenti

Questa pagina è stata utile?