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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через