PostBackOptions Класс

Ссылка

Определение

Пространство имен:: System.Web.UI

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Указывает, как создается клиентский скрипт JavaScript для инициации обратной передачи.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Наследование: Object
PostBackOptions

Примеры

В следующем примере кода используется OnClick событие элемента управления для создания клиентского Button скрипта для HyperLink элемента управления, который позволит HyperLink элементу управления вызвать событие обратной передачи. ActionUrl Так как для свойства объекта задано значение myPostBackOptions Page2.aspx, обратная отправка будет размещать страницу веб-формы на другую страницу с именем Page2.aspx, которая не указана здесь. Чтобы использовать этот пример, необходимо добавить в проект или каталог еще одну веб-страницу с именем Page2.aspx.

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

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

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

Класс PostBackOptions позволяет элементам управления выдавать клиентский скрипт, который инициирует событие обратной передачи. Класс PostBackOptions также предоставляет ссылку на элемент управления, который инициировал событие обратной передачи TargetControl через свойство. Событие обратной передачи создается на основе параметров, указанных в объекте, PostBackOptions переданном методу ClientScriptManager.GetPostBackEventReference .

Как правило, обратная передача на сервер инициируется такими элементами, как кнопка "Отправить" или кнопка "Изображение". Однако путем отправки клиентского Кода JavaScript различные элементы управления могут инициировать событие обратной передачи.

Конструкторы

PostBackOptions(Control)	Инициализирует новый экземпляр класса PostBackOptions с указанными данными конечного элемента управления.
PostBackOptions(Control, String)	Инициализирует новый экземпляр класса PostBackOptions с указанными данными конечного элемента управления и аргумента.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Инициализирует новый экземпляр класса PostBackOptions с указанными значениями свойств экземпляра.

Свойства

ActionUrl	Получает и задает целевой URL-адрес для обратной передачи страницы веб-форм.
Argument	Получает и задает необязательный аргумент, который пересылается при обратной передаче.
AutoPostBack	Получает и задает значение, показывающее, предается ли автоматически форма обратно на сервер в ответ на действия пользователя.
ClientSubmit	Получает и задает значение, указывающее, должна ли инициироваться обратная передача клиентским скриптом.
PerformValidation	Получает и задает значение, указывающее, требуется ли проверка на стороне клиента перед обратной передачей.
RequiresJavaScriptProtocol	Возвращает или задает значение, указывающее, формируется ли префикс `javascript:` для клиентского скрипта.
TargetControl	Возвращает конечный элемент управления, который получает данные обратной передачи.
TrackFocus	Возвращает или задает значение, указывающее, должна ли обратная передача возвращать страницу в текущую позицию прокрутки и возвращать фокус в текущий элемент управления.
ValidationGroup	Возвращает или задает группу элементов управления, для которых объект PostBackOptions инициирует проверку при обратной передаче.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к

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

GetPostBackEventReference(PostBackOptions)