PostBackOptions PostBackOptions PostBackOptions PostBackOptions Class

Definizione

Specifica come viene generato uno script JavaScript del lato client per avviare un evento di postback.Specifies how client-side JavaScript is generated to initiate a postback event.

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
Ereditarietà
PostBackOptionsPostBackOptionsPostBackOptionsPostBackOptions

Esempi

Nell'esempio di codice seguente viene OnClick usato l'evento Button di un controllo per generare script sul lato client HyperLink per un controllo che consentirà al HyperLink controllo di causare un evento postback.The following code example uses the OnClick event of a Button control to generate client-side script for a HyperLink control that will allow the HyperLink control to cause a postback event. Poiché la ActionUrl proprietà myPostBackOptions dell'oggetto è impostata su "pagina2. aspx", il postback pubblicherà la pagina Web Form in un'altra pagina denominata "pagina2. aspx", che non è disponibile qui.Because the ActionUrl property of the myPostBackOptions object is set to "Page2.aspx", the postback will post the Web Forms page to another page named "Page2.aspx", which is not provided here. Per usare questo esempio, è necessario aggiungere un'altra pagina Web denominata "pagina2. aspx" al progetto o alla directory.To use this example, you must add another Web page named "Page2.aspx" to your project or 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.The following code example is a Web page that can be used to run the preceding code-behind file.

<%@ 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 creare script sul lato client che avvia un evento postback.The PostBackOptions class allows controls to emit client-side script that initiates a postback event. La PostBackOptions classe fornisce inoltre un riferimento al controllo che ha avviato l'evento di postback tramite la TargetControl proprietà.The PostBackOptions class also provides a reference to the control that initiated the postback event through the TargetControl property. L'evento postback viene creato in base alle opzioni specificate nell' PostBackOptions oggetto passato ClientScriptManager.GetPostBackEventReference al metodo.The postback event is created based on the options specified in the PostBackOptions object passed in to the ClientScriptManager.GetPostBackEventReference method.

In genere, un postback al server viene avviato da elementi quali un pulsante di invio o un pulsante di immagine.Normally, a postback to the server is initiated by elements such as a Submit button or an Image button. Tuttavia, tramite la creazione di JavaScript sul lato client, diversi controlli possono avviare un evento postback.However, by emitting client-side JavaScript, different controls can initiate a postback event.

Costruttori

PostBackOptions(Control) PostBackOptions(Control) PostBackOptions(Control) PostBackOptions(Control)

Inizializza una nuova istanza della classe PostBackOptions con i dati del controllo di destinazione specificati.Initializes a new instance of the PostBackOptions class with the specified target control data.

PostBackOptions(Control, String) PostBackOptions(Control, String) PostBackOptions(Control, String) PostBackOptions(Control, String)

Inizializza una nuova istanza della classe PostBackOptions con i dati del controllo e dell'argomento di destinazione specificati.Initializes a new instance of the PostBackOptions class with the specified target control and argument data.

PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Inizializza una nuova istanza della classe PostBackOptions con i valori specificati per le proprietà dell'istanza.Initializes a new instance of the PostBackOptions class with the specified values for the instance's properties.

Proprietà

ActionUrl ActionUrl ActionUrl ActionUrl

Ottiene o imposta l'URL di destinazione per il postback di una pagina Web Form.Gets or sets the target URL for the postback of a Web Forms page.

Argument Argument Argument Argument

Ottiene o imposta un argomento facoltativo che viene trasferito nell'evento di postback.Gets or sets an optional argument that is transferred in the postback event.

AutoPostBack AutoPostBack AutoPostBack AutoPostBack

Ottiene o imposta un valore che indica se verrà eseguito il postback automatico del form al server in risposta a un'azione dell'utente.Gets or sets a value that indicates whether the form will automatically post back to the server in response to a user action.

ClientSubmit ClientSubmit ClientSubmit ClientSubmit

Ottiene o imposta un valore che indica se l'evento di postback deve essere avviato dallo script del lato client.Gets or sets a value indicating whether the postback event should occur from client-side script.

PerformValidation PerformValidation PerformValidation PerformValidation

Ottiene o imposta un valore che indica se è necessaria la convalida del lato client prima dell'avvio dell'evento di postback.Gets or sets a value indicating whether client-side validation is required before the postback event occurs.

RequiresJavaScriptProtocol RequiresJavaScriptProtocol RequiresJavaScriptProtocol RequiresJavaScriptProtocol

Ottiene o imposta un valore che indica se il prefisso javascript: viene generato per lo script del lato client.Gets or sets a value indicating whether the javascript: prefix is generated for the client-side script.

TargetControl TargetControl TargetControl TargetControl

Ottiene la destinazione del controllo che riceve l'evento di postback.Gets the control target that receives the postback event.

TrackFocus TrackFocus TrackFocus TrackFocus

Ottiene o imposta un valore che indica se l'evento di postback deve riportare la pagina alla posizione corrente e ripristinare lo stato attivo sul controllo corrente.Gets or sets a value indicating whether the postback event should return the page to the current scroll position and return focus to the current control.

ValidationGroup ValidationGroup ValidationGroup ValidationGroup

Ottiene o imposta il gruppo di controlli per il quale l'oggetto PostBackOptions provoca la convalida in occasione del postback al server.Gets or sets the group of controls for which the PostBackOptions object causes validation when it posts back to the server.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche