PostBackOptions Třída

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 vygeneruje JavaScript na straně klienta pro zahájení události postback.

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 k vygenerování klientského skriptu pro HyperLink ovládací prvek, který umožní HyperLink řízení způsobit postback událost. Vzhledem k tomu, že ActionUrl vlastnost objektu myPostBackOptions je nastavena na "Page2.aspx", postback publikuje stránku webové formuláře na jinou stránku s názvem "Page2.aspx", která zde není uvedena. Pokud chcete tento příklad použít, 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, která se dá použít ke spuštění předchozího souboru s kódem.

<%@ 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 postback. Třída PostBackOptions také poskytuje odkaz na ovládací prvek, který inicioval postback událost prostřednictvím TargetControl vlastnosti. Postback událost je vytvořena na základě možností zadaných v PostBackOptions objektu předané metodě ClientScriptManager.GetPostBackEventReference .

Za normálních okolností je postback na server inicializován 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 zahájit událost postback.

Konstruktory

Name	Description
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicializuje novou instanci PostBackOptions třídy se zadanými hodnotami pro vlastnosti instance.
PostBackOptions(Control, String)	Inicializuje novou instanci PostBackOptions třídy se zadaným cílovým ovládacím prvku a daty argumentů.
PostBackOptions(Control)	Inicializuje novou instanci PostBackOptions třídy se zadanými cílovými řídicími daty.

Vlastnosti

Name	Description
ActionUrl	Získá nebo nastaví cílovou adresu URL pro postback stránky webové formuláře.
Argument	Získá nebo nastaví volitelný argument, který je přenesen v postback události.
AutoPostBack	Získá nebo nastaví hodnotu, která určuje, zda formulář automaticky odešle zpět na server v reakci na akci uživatele.
ClientSubmit	Získá nebo nastaví hodnotu urč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 požadováno ověření na straně klienta před událostí postback dojde.
RequiresJavaScriptProtocol	Získá nebo nastaví hodnotu urč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 určující, zda událost postback má 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í, když publikuje zpět na server.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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)

Váš názor

Byla tato stránka užitečná?