PostBackOptions Třída

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Určuje, jak se na straně klienta vygeneruje JavaScript pro inicializaci události zpětného odeslání.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Dědičnost: Object
PostBackOptions

Příklady

Následující příklad kódu používá OnClick událost Button ovládacího prvku ke generování skriptu na straně klienta pro HyperLink ovládací prvek, který umožní HyperLink ovládací prvek způsobit postback událost. Vzhledem k ActionUrl tomu, že vlastnost objektu myPostBackOptions je nastavena na "Page2.aspx", postback odešle Web Forms stránku na jinou stránku s názvem "Page2.aspx", která zde není k dispozici. Chcete-li použít tento příklad, musíte do projektu nebo adresáře přidat další webovou stránku s názvem "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

Následující příklad kódu je webová stránka, kterou lze použít ke spuštění předchozího souboru kódu na pozadí.

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

Poznámky

Třída PostBackOptions umožňuje ovládacím prvkům generovat skript na straně klienta, který inicializuje událost zpětného odeslání. Třída PostBackOptions také poskytuje odkaz na ovládací prvek, který inicioval událost postback prostřednictvím TargetControl vlastnosti . Událost postback je vytvořena na základě možností zadaných v objektu PostBackOptions předaném ClientScriptManager.GetPostBackEventReference metodě .

Postback na server obvykle iniciují prvky, jako je tlačítko Odeslat nebo tlačítko Obrázek. Generováním JavaScriptu na straně klienta však mohou různé ovládací prvky iniciovat událost zpětného odeslání.

Konstruktory

PostBackOptions(Control)	Inicializuje novou instanci třídy se zadanými daty cílového PostBackOptions ovládacího prvku.
PostBackOptions(Control, String)	Inicializuje novou instanci PostBackOptions třídy se zadaným cílovým ovládacím prvku a daty argumentu.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicializuje novou instanci PostBackOptions třídy se zadanými hodnotami vlastností instance.

Vlastnosti

ActionUrl	Získá nebo nastaví cílovou adresu URL pro postback Web Forms stránky.
Argument	Získá nebo nastaví volitelný argument, který je přenesen v postback události.
AutoPostBack	Získá nebo nastaví hodnotu, která označuje, zda bude formulář automaticky publikovat zpět na server v reakci na akci uživatele.
ClientSubmit	Získá nebo nastaví hodnotu označující, zda postback událost má dojít ze skriptu na straně klienta.
PerformValidation	Získá nebo nastaví hodnotu označující, zda je vyžadováno ověření na straně klienta před postback událostí dojde.
RequiresJavaScriptProtocol	Získá nebo nastaví hodnotu označující, zda `javascript:` je předpona generována pro skript na straně klienta.
TargetControl	Získá cíl ovládacího prvku, který obdrží postback událost.
TrackFocus	Získá nebo nastaví hodnotu označující, zda postback událost vrátit stránku na aktuální pozici posouvání a vrátit fokus na aktuální ovládací prvek.
ValidationGroup	Získá nebo nastaví skupinu ovládacích prvků, pro které PostBackOptions objekt způsobí ověření při odeslání zpět na server.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro

Viz také

GetPostBackEventReference(PostBackOptions)