ClientScriptManager.GetPostBackEventReference Méthode

Définition

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server.

Surcharges

GetPostBackEventReference(Control, String, Boolean)

Retourne une chaîne à utiliser dans un événement client pour provoquer une publication sur le serveur.Returns a string to use in a client event to cause postback to the server. La chaîne de référence est définie par le contrôle spécifié qui gère la publication (postback) et un argument de chaîne d'autres informations d'événement.The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Inscrit en option la référence d'événement pour la validation.Optionally, registers the event reference for validation.

GetPostBackEventReference(PostBackOptions, Boolean)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par l'objet PostBackOptions spécifié.The reference string is defined by the specified PostBackOptions object. Inscrit en option la référence d'événement pour la validation.Optionally, registers the event reference for validation.

GetPostBackEventReference(PostBackOptions)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par l'instance de PostBackOptions spécifiée.The reference string is defined by the specified PostBackOptions instance.

GetPostBackEventReference(Control, String)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par le contrôle spécifié qui gère la publication (postback) et un argument de chaîne d'autres informations d'événement.The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

GetPostBackEventReference(Control, String, Boolean)

Retourne une chaîne à utiliser dans un événement client pour provoquer une publication sur le serveur.Returns a string to use in a client event to cause postback to the server. La chaîne de référence est définie par le contrôle spécifié qui gère la publication (postback) et un argument de chaîne d'autres informations d'événement.The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Inscrit en option la référence d'événement pour la validation.Optionally, registers the event reference for validation.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, bool registerForEventValidation);
public string GetPostBackEventReference (System.Web.UI.Control control, string argument, bool registerForEventValidation);
member this.GetPostBackEventReference : System.Web.UI.Control * string * bool -> string

Paramètres

control
Control

Control serveur qui traite la publication sur le serveur.The server Control that processes the postback on the server.

argument
String

Chaîne d'arguments facultatifs à passer à control.A string of optional arguments to pass to control.

registerForEventValidation
Boolean

true pour inscrire la référence d'événement en vue de la validation ; sinon, false.true to register the event reference for validation; otherwise, false.

Retours

Chaîne qui, traitée comme un script sur le client, initialise la publication (postback).A string that, when treated as script on the client, initiates the postback.

Exceptions

Le Control spécifié a la valeur null.The specified Control is null.

Remarques

Pour implémenter l’interface IPostBackEventHandler pour un Page, utilisez la directive.To implement the IPostBackEventHandler interface for a Page, use the directive.

La méthode GetPostBackEventReference peut être utilisée avec le contrôle Button lorsque la propriété UseSubmitBehavior est false.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. Dans ce scénario, la méthode GetPostBackEventReference retourne l’événement de publication client pour le contrôle Button.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Si registerForEventValidation a la valeur true, la méthode GetPostBackEventReference(PostBackOptions, Boolean) appelle la méthode RegisterForEventValidation(String, String) pour inscrire la référence d’événement pour la validation avec un ID de contrôle unique qui représente le contrôle client qui génère l’événement.If registerForEventValidation is true, the GetPostBackEventReference(PostBackOptions, Boolean) method calls the RegisterForEventValidation(String, String) method to register the event reference for validation with a unique control ID that represents the client control that is generating the event.

Voir aussi

GetPostBackEventReference(PostBackOptions, Boolean)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par l'objet PostBackOptions spécifié.The reference string is defined by the specified PostBackOptions object. Inscrit en option la référence d'événement pour la validation.Optionally, registers the event reference for validation.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options, bool registerForEventValidation);
public string GetPostBackEventReference (System.Web.UI.PostBackOptions options, bool registerForEventValidation);
member this.GetPostBackEventReference : System.Web.UI.PostBackOptions * bool -> string
Public Function GetPostBackEventReference (options As PostBackOptions, registerForEventValidation As Boolean) As String

Paramètres

options
PostBackOptions

PostBackOptions qui définit une publication.A PostBackOptions that defines the postback.

registerForEventValidation
Boolean

true pour inscrire la référence d'événement en vue de la validation ; sinon, false.true to register the event reference for validation; otherwise, false.

Retours

Chaîne qui, traitée comme un script sur le client, initialise la publication cliente.A string that, when treated as script on the client, initiates the client postback.

Exceptions

Remarques

Pour implémenter l’interface IPostBackEventHandler pour un objet Page, utilisez la directive.To implement the IPostBackEventHandler interface for a Page object, use the directive.

La méthode GetPostBackEventReference peut être utilisée avec le contrôle Button lorsque la propriété UseSubmitBehavior est false.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. Dans ce scénario, la méthode GetPostBackEventReference retourne l’événement de publication client pour le contrôle Button.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Si registerForEventValidation est true, la méthode GetPostBackEventReference(PostBackOptions, Boolean) appelle la méthode RegisterForEventValidation(String, String) pour inscrire la référence d’événement pour la validation avec un ID de contrôle unique qui représente le contrôle client qui génère l’événement.If registerForEventValidation is true, the GetPostBackEventReference(PostBackOptions, Boolean) method calls the RegisterForEventValidation(String, String) method to register the event reference for validation with a unique control ID that represents the client control that is generating the event.

Voir aussi

GetPostBackEventReference(PostBackOptions)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par l'instance de PostBackOptions spécifiée.The reference string is defined by the specified PostBackOptions instance.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options);
public string GetPostBackEventReference (System.Web.UI.PostBackOptions options);
member this.GetPostBackEventReference : System.Web.UI.PostBackOptions -> string
Public Function GetPostBackEventReference (options As PostBackOptions) As String

Paramètres

options
PostBackOptions

PostBackOptions qui définit une publication.A PostBackOptions that defines the postback.

Retours

Chaîne qui, traitée comme un script sur le client, initialise la publication cliente.A string that, when treated as script on the client, initiates the client postback.

Exceptions

Le paramètre PostBackOptions est null.The PostBackOptions parameter is null

Remarques

Pour implémenter l’interface IPostBackEventHandler pour un Page, utilisez la directive.To implement the IPostBackEventHandler interface for a Page, use the directive.

La méthode GetPostBackEventReference peut être utilisée avec le contrôle Button lorsque la propriété UseSubmitBehavior est false.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. Dans ce scénario, la méthode GetPostBackEventReference retourne l’événement de publication client pour le contrôle Button.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Voir aussi

GetPostBackEventReference(Control, String)

Retourne une chaîne qui peut être utilisée dans un événement client pour provoquer une publication (postback) sur le serveur.Returns a string that can be used in a client event to cause postback to the server. La chaîne de référence est définie par le contrôle spécifié qui gère la publication (postback) et un argument de chaîne d'autres informations d'événement.The reference string is defined by the specified control that handles the postback and a string argument of additional event information.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument);
public string GetPostBackEventReference (System.Web.UI.Control control, string argument);
member this.GetPostBackEventReference : System.Web.UI.Control * string -> string

Paramètres

control
Control

Control serveur qui traite la publication sur le serveur.The server Control that processes the postback on the server.

argument
String

Chaîne d'arguments facultative à passer au contrôle qui traite la publication.A string of optional arguments to pass to the control that processes the postback.

Retours

Chaîne qui, traitée comme un script sur le client, initialise la publication (postback).A string that, when treated as script on the client, initiates the postback.

Exceptions

Le Control spécifié a la valeur null.The specified Control is null.

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode GetPostBackEventReference.The following code example demonstrates the use of the GetPostBackEventReference method. Le contrôle personnalisé, MyControl, implémente l’interface IPostBackEventHandler.The custom control, MyControl, implements the IPostBackEventHandler interface. Quand l’utilisateur clique sur le bouton sur la page, la méthode RaisePostBackEvent du contrôle personnalisé est appelée.When the button on the page is clicked, the RaisePostBackEvent method of the custom control is invoked.

<%@ Page Language="C#"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  public class MyControl : Label, IPostBackEventHandler
  {

    // Use the constructor to defined default label text.
    public MyControl()
    {
      base.Text = "No postback raised.";
    }
    
    // Implement the RaisePostBackEvent method from the
    // IPostBackEventHandler interface. 
    public void RaisePostBackEvent(string eventArgument)
    {
      base.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + ".";
      
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Create an instance of the custom label control and 
    // add it to the page.
    MyControl mycontrol = new MyControl();
    mycontrol.ID = "mycontrol1";
    PlaceHolder1.Controls.Add(mycontrol);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(mycontrol, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(mycontrol, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Public Class MyControl
    Inherits Label
    Implements IPostBackEventHandler
     
    Public Sub New()
      
      MyBase.Text = "No postback raised."
    
    End Sub
    
    Public Sub RaisePostBackEvent(ByVal eventArgument As String) Implements System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
      
      MyBase.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
                "Postback caused by " + eventArgument.ToString() & "."

    End Sub
    
  End Class
   

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript

    ' Create an instance of the custom label control and 
    ' add it to the page.
    Dim mycontrol As New MyControl()
    MyControl.ID = "mycontrol1"
    PlaceHolder1.Controls.Add(MyControl)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(MyControl, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(MyControl, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

L’exemple de code suivant a les mêmes fonctionnalités que le précédent, sauf qu’au lieu d’un contrôle personnalisé, la classe Page implémente l’interface IPostBackEventHandler.The following code example has the same functionality as the preceding one, except that instead of a custom control, the Page class implements the IPostBackEventHandler interface.

<%@ Page Language="C#"  %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  public void RaisePostBackEvent(string eventArgument)
  {
    Label1.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + "."; ;
  }
  
  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(this, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(this, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
  Public Sub RaisePostBackEvent(ByVal eventArgument As String) _
    Implements IPostBackEventHandler.RaisePostBackEvent
    
    Label1.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
           "Postback caused by " + eventArgument.ToString() & "."
  
  End Sub
  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(Me, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(Me, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

Remarques

Pour implémenter l’interface IPostBackEventHandler pour un Page, utilisez la directive.To implement the IPostBackEventHandler interface for a Page, use the directive.

La méthode GetPostBackEventReference peut être utilisée avec le contrôle Button lorsque la propriété UseSubmitBehavior est false.The GetPostBackEventReference method can be used with the Button control when the UseSubmitBehavior property is false. Dans ce scénario, la méthode GetPostBackEventReference retourne l’événement de publication client pour le contrôle Button.In this scenario, the GetPostBackEventReference method returns the client postback event for the Button control.

Voir aussi

S’applique à