PostBackOptions Classe

Définition

Spécifie la façon dont le code JavaScript côté client est généré pour initier un événement de publication.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
Héritage
PostBackOptions

Exemples

L’exemple de code suivant utilise l' OnClick événement d’un Button contrôle pour générer un script côté client pour un HyperLink contrôle qui permet au HyperLink contrôle de provoquer un événement de publication (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. Étant donné que la ActionUrl propriété de l' myPostBackOptions objet est définie sur « page2. aspx », la publication publiera la Web Forms page sur une autre page nommée « page2. aspx », qui n’est pas fournie ici.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. Pour utiliser cet exemple, vous devez ajouter une autre page Web nommée « page2. aspx » à votre projet ou répertoire.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’exemple de code suivant est une page Web qui peut être utilisée pour exécuter le fichier code-behind précédent.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>

Remarques

La PostBackOptions classe permet aux contrôles d’émettre un script côté client qui initie un événement de publication (postback).The PostBackOptions class allows controls to emit client-side script that initiates a postback event. La PostBackOptions classe fournit également une référence au contrôle qui a initié l’événement de publication via la TargetControl propriété.The PostBackOptions class also provides a reference to the control that initiated the postback event through the TargetControl property. L’événement de publication (postback) est créé en fonction des options spécifiées dans l' PostBackOptions objet passé à la ClientScriptManager.GetPostBackEventReference méthode.The postback event is created based on the options specified in the PostBackOptions object passed in to the ClientScriptManager.GetPostBackEventReference method.

Normalement, une publication sur le serveur est initiée par des éléments tels qu’un bouton envoyer ou un bouton image.Normally, a postback to the server is initiated by elements such as a Submit button or an Image button. Toutefois, en émettant du code JavaScript côté client, différents contrôles peuvent initier un événement de publication (postback).However, by emitting client-side JavaScript, different controls can initiate a postback event.

Constructeurs

PostBackOptions(Control)

Initialise une nouvelle instance de la classe PostBackOptions avec les données du contrôle cible spécifié.Initializes a new instance of the PostBackOptions class with the specified target control data.

PostBackOptions(Control, String)

Initialise une nouvelle instance de la classe PostBackOptions avec les données du contrôle cible et de l'argument spécifiés.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)

Initialise une nouvelle instance de la classe PostBackOptions avec les valeurs des propriétés de l'instance spécifiées.Initializes a new instance of the PostBackOptions class with the specified values for the instance's properties.

Propriétés

ActionUrl

Obtient ou définit l'URL cible pour la publication d'une page Web Forms.Gets or sets the target URL for the postback of a Web Forms page.

Argument

Obtient ou définit un argument facultatif qui est transféré dans l'événement de publication.Gets or sets an optional argument that is transferred in the postback event.

AutoPostBack

Obtient ou définit une valeur qui indique si le formulaire sera publié automatiquement sur le serveur en réponse à une action de l'utilisateur.Gets or sets a value that indicates whether the form will automatically post back to the server in response to a user action.

ClientSubmit

Obtient ou définit une valeur indiquant si l'événement de publication doit se produire à partir du script côté client.Gets or sets a value indicating whether the postback event should occur from client-side script.

PerformValidation

Obtient ou définit une valeur indiquant si la validation côté client est requise avant l'événement de publication.Gets or sets a value indicating whether client-side validation is required before the postback event occurs.

RequiresJavaScriptProtocol

Obtient ou définit une valeur indiquant si le préfixe javascript: est généré pour le script côté client.Gets or sets a value indicating whether the javascript: prefix is generated for the client-side script.

TargetControl

Obtient le contrôle cible qui reçoit l'événement de publication.Gets the control target that receives the postback event.

TrackFocus

Obtient ou définit une valeur indiquant si l'événement de publication doit retourner la page à la position de défilement en cours et le focus au contrôle actif.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

Obtient ou définit le groupe de contrôles pour lequel l'objet PostBackOptions provoque la validation lors de la publication sur le serveur.Gets or sets the group of controls for which the PostBackOptions object causes validation when it posts back to the server.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi