PostBackOptions Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa sposób generowania kodu JavaScript po stronie klienta w celu zainicjowania zdarzenia ogłaszania zwrotnego.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Dziedziczenie: Object
PostBackOptions

Przykłady

Poniższy przykład kodu używa OnClick zdarzenia kontrolki Button do generowania skryptu po stronie klienta dla HyperLink kontrolki, która pozwoli kontrolce HyperLink spowodować zdarzenie ogłaszania zwrotnego. ActionUrl Ponieważ właściwość myPostBackOptions obiektu jest ustawiona na "Page2.aspx", ogłaszanie zwrotne spowoduje opublikowanie strony Web Forms na inną stronę o nazwie "Page2.aspx", która nie jest tutaj podana. Aby użyć tego przykładu, musisz dodać do projektu lub katalogu inną stronę sieci Web o nazwie "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

Poniższy przykład kodu to strona internetowa, która może służyć do uruchamiania poprzedniego pliku za kodem.

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

Uwagi

Klasa PostBackOptions umożliwia sterowanie emitowania skryptu po stronie klienta, który inicjuje zdarzenie ogłaszania zwrotnego. Klasa PostBackOptions udostępnia również odwołanie do kontrolki, która zainicjowała zdarzenie ogłaszania zwrotnego TargetControl za pośrednictwem właściwości . Zdarzenie ogłaszania zwrotnego jest tworzone na podstawie opcji określonych w PostBackOptions obiekcie przekazanym ClientScriptManager.GetPostBackEventReference do metody .

Zwykle ogłaszanie zwrotne na serwerze jest inicjowane przez elementy, takie jak przycisk Prześlij lub przycisk Obraz. Jednak emitując kod JavaScript po stronie klienta, różne kontrolki mogą inicjować zdarzenie ogłaszania zwrotnego.

Konstruktory

PostBackOptions(Control)	Inicjuje PostBackOptions nowe wystąpienie klasy z określonymi docelowymi danymi sterującymi.
PostBackOptions(Control, String)	Inicjuje PostBackOptions nowe wystąpienie klasy z określoną kontrolką docelową i danymi argumentów.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicjuje PostBackOptions nowe wystąpienie klasy z określonymi wartościami właściwości wystąpienia.

Właściwości

ActionUrl	Pobiera lub ustawia docelowy adres URL dla ogłaszania zwrotnego strony Web Forms.
Argument	Pobiera lub ustawia opcjonalny argument, który jest transferowany w zdarzeniu ogłaszania zwrotnego.
AutoPostBack	Pobiera lub ustawia wartość, która wskazuje, czy formularz automatycznie opublikuje się z powrotem na serwerze w odpowiedzi na akcję użytkownika.
ClientSubmit	Pobiera lub ustawia wartość wskazującą, czy zdarzenie ogłaszania zwrotnego powinno nastąpić ze skryptu po stronie klienta.
PerformValidation	Pobiera lub ustawia wartość wskazującą, czy weryfikacja po stronie klienta jest wymagana przed wystąpieniem zdarzenia ogłaszania zwrotnego.
RequiresJavaScriptProtocol	Pobiera lub ustawia wartość wskazującą, czy `javascript:` prefiks jest generowany dla skryptu po stronie klienta.
TargetControl	Pobiera element docelowy kontrolki, który odbiera zdarzenie ogłaszania zwrotnego.
TrackFocus	Pobiera lub ustawia wartość wskazującą, czy zdarzenie ogłaszania zwrotnego powinno zwrócić stronę do bieżącej pozycji przewijania i zwrócić fokus do bieżącej kontrolki.
ValidationGroup	Pobiera lub ustawia grupę kontrolek, dla których PostBackOptions obiekt powoduje walidację po wysłaniu z powrotem do serwera.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy

Zobacz też

GetPostBackEventReference(PostBackOptions)