ClientScriptManager.GetPostBackEventReference Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер.

Перегрузки

Имя	Описание
GetPostBackEventReference(Control, String, Boolean)	Возвращает строку, используемую в событии клиента, чтобы вызвать обратную передачу на сервер. Ссылочная строка определяется указанным элементом управления, обрабатывающим обратную передачу и строковый аргумент дополнительных сведений о событии. При необходимости регистрирует ссылку на события для проверки.
GetPostBackEventReference(PostBackOptions, Boolean)	Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным PostBackOptions объектом. При необходимости регистрирует ссылку на события для проверки.
GetPostBackEventReference(PostBackOptions)	Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылка определяется указанным PostBackOptions экземпляром.
GetPostBackEventReference(Control, String)	Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным элементом управления, обрабатывающим обратную передачу и строковый аргумент дополнительных сведений о событии.

GetPostBackEventReference(Control, String, Boolean)

Возвращает строку, используемую в событии клиента, чтобы вызвать обратную передачу на сервер. Ссылочная строка определяется указанным элементом управления, обрабатывающим обратную передачу и строковый аргумент дополнительных сведений о событии. При необходимости регистрирует ссылку на события для проверки.

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

Public Function GetPostBackEventReference (control As Control, argument As String, registerForEventValidation As Boolean) As String

Параметры

control

Control

Сервер Control , обрабатывающий обратную передачу на сервере.

argument

String

Строка необязательных аргументов для передачи controlв .

registerForEventValidation

Boolean

true регистрация ссылки на события для проверки; falseв противном случае .

Возвращаемое значение

String

Строка, которая при обработке как скрипта на клиенте инициирует обратную передачу.

Исключения

ArgumentNullException

Указан Controlnull.

Комментарии

Чтобы реализовать IPostBackEventHandler интерфейс для Pagea, используйте директиву @ Implements .

Метод GetPostBackEventReference можно использовать с элементом Button управления при UseSubmitBehavior использовании falseсвойства. В этом сценарии GetPostBackEventReference метод возвращает событие обратной Button передачи клиента для элемента управления.

Если registerForEventValidation задано значение true, GetPostBackEventReference(PostBackOptions, Boolean) метод вызывает RegisterForEventValidation(String, String) метод для регистрации ссылки на события для проверки с уникальным идентификатором элемента управления, который представляет клиентский элемент управления, создающий событие.

См. также раздел

• PostBackOptions
• IPostBackEventHandler
• Обратные вызовы клиента без обратной передачи на страницах ASP.NET

GetPostBackEventReference(PostBackOptions, Boolean)

Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным PostBackOptions объектом. При необходимости регистрирует ссылку на события для проверки.

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

Параметры

options

PostBackOptions

Ответ, PostBackOptions определяющий обратную передачу.

registerForEventValidation

Boolean

true регистрация ссылки на события для проверки; falseв противном случае .

Возвращаемое значение

String

Строка, которая при обработке как скрипта на клиенте инициирует обратную передачу клиента.

Исключения

ArgumentNullException

Значение параметра PostBackOptions — null.

Комментарии

Чтобы реализовать IPostBackEventHandler интерфейс для Page объекта, используйте директиву @ Implements .

Метод GetPostBackEventReference можно использовать с элементом Button управления при UseSubmitBehavior использовании falseсвойства. В этом сценарии GetPostBackEventReference метод возвращает событие обратной Button передачи клиента для элемента управления.

Если registerForEventValidation это trueтак, GetPostBackEventReference(PostBackOptions, Boolean) метод вызывает RegisterForEventValidation(String, String) метод для регистрации ссылки на события для проверки с уникальным идентификатором элемента управления, который представляет клиентский элемент управления, создающий событие.

См. также раздел

• PostBackOptions
• IPostBackEventHandler
• Button
• Обратные вызовы клиента без обратной передачи на страницах ASP.NET

GetPostBackEventReference(PostBackOptions)

Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылка определяется указанным PostBackOptions экземпляром.

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

Параметры

options

PostBackOptions

Ответ, PostBackOptions определяющий обратную передачу.

Возвращаемое значение

String

Строка, которая при обработке как скрипта на клиенте инициирует обратную передачу клиента.

Исключения

ArgumentNullException

Параметр PostBackOptions имеет значение null

Комментарии

Чтобы реализовать IPostBackEventHandler интерфейс для Pagea, используйте директиву @ Implements .

Метод GetPostBackEventReference можно использовать с элементом Button управления при UseSubmitBehavior использовании falseсвойства. В этом сценарии GetPostBackEventReference метод возвращает событие обратной Button передачи клиента для элемента управления.

См. также раздел

• PostBackOptions
• IPostBackEventHandler
• Button
• Обратные вызовы клиента без обратной передачи на страницах ASP.NET

GetPostBackEventReference(Control, String)

Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным элементом управления, обрабатывающим обратную передачу и строковый аргумент дополнительных сведений о событии.

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

Public Function GetPostBackEventReference (control As Control, argument As String) As String

Параметры

control

Control

Сервер Control , обрабатывающий обратную передачу на сервере.

argument

String

Строка необязательных аргументов для передачи в элемент управления, обрабатывающий обратную передачу.

Возвращаемое значение

String

Строка, которая при обработке как скрипта на клиенте инициирует обратную передачу.

Исключения

ArgumentNullException

Указан Controlnull.

Примеры

В следующем примере кода показано использование GetPostBackEventReference метода. Пользовательский элемент управления MyControlреализует IPostBackEventHandler интерфейс. При нажатии RaisePostBackEvent кнопки на странице вызывается метод пользовательского элемента управления.

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

В следующем примере кода есть те же функции, что и предыдущий, за исключением того, что вместо пользовательского элемента управления Page класс реализует IPostBackEventHandler интерфейс.

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

Комментарии

Чтобы реализовать IPostBackEventHandler интерфейс для Pagea, используйте директиву @ Implements .

Метод GetPostBackEventReference можно использовать с элементом Button управления при UseSubmitBehavior использовании falseсвойства. В этом сценарии GetPostBackEventReference метод возвращает событие обратной Button передачи клиента для элемента управления.

См. также раздел

• PostBackOptions
• IPostBackEventHandler
• Обратные вызовы клиента без обратной передачи на страницах ASP.NET