PostBackOptions Klasa

Definicja

Określa sposób generowania kodu JavaScript po stronie klienta w celu zainicjowania zdarzenia ogłaszania zwrotnego.Specifies how client-side JavaScript is generated to initiate a postback event.

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
Dziedziczenie
PostBackOptions

Przykłady

Poniższy przykład kodu używa OnClick zdarzenia Button kontrolki do wygenerowania skryptu po stronie klienta dla HyperLink kontrolki, która umożliwi HyperLink formantowi wystąpienie zdarzenia ogłaszania zwrotnego.The following code example uses the OnClick event of a Button control to generate client-side script for a HyperLink control that will allow the HyperLink control to cause a postback event. Ponieważ ActionUrl Właściwość myPostBackOptions obiektu ma ustawioną wartość "Page2. aspx", ogłaszanie zwrotne opublikuje stronę formularzy sieci Web na innej stronie o nazwie "Page2. aspx", która nie jest dostępna w tym miejscu.Because the ActionUrl property of the myPostBackOptions object is set to "Page2.aspx", the postback will post the Web Forms page to another page named "Page2.aspx", which is not provided here. Aby użyć tego przykładu, należy dodać kolejną stronę sieci Web o nazwie "Page2. aspx" do projektu lub katalogu.To use this example, you must add another Web page named "Page2.aspx" to your project or directory.

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 jest stroną sieci Web, za pomocą której można uruchomić poprzedni plik związany z kodem.The following code example is a Web page that can be used to run the preceding code-behind file.

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

PostBackOptionsKlasa umożliwia kontrolom emitowanie skryptu po stronie klienta, który inicjuje zdarzenie ogłaszania zwrotnego.The PostBackOptions class allows controls to emit client-side script that initiates a postback event. PostBackOptionsKlasa zawiera również odwołanie do kontrolki, która zainicjowała zdarzenie ogłaszania zwrotnego za pomocą TargetControl właściwości.The PostBackOptions class also provides a reference to the control that initiated the postback event through the TargetControl property. Zdarzenie ogłaszania zwrotnego jest tworzone na podstawie opcji określonych w PostBackOptions obiekcie przekazaną do ClientScriptManager.GetPostBackEventReference metody.The postback event is created based on the options specified in the PostBackOptions object passed in to the ClientScriptManager.GetPostBackEventReference method.

Zwykle ogłaszanie zwrotne na serwerze jest inicjowane przez elementy, takie jak przycisk Prześlij lub przycisk obrazu.Normally, a postback to the server is initiated by elements such as a Submit button or an Image button. Jednak przez emitowanie kodu JavaScript po stronie klienta inne kontrolki mogą inicjować zdarzenie ogłaszania zwrotnego.However, by emitting client-side JavaScript, different controls can initiate a postback event.

Konstruktory

PostBackOptions(Control)

Inicjuje nowe wystąpienie PostBackOptions klasy z określonymi docelowymi danymi kontrolnymi.Initializes a new instance of the PostBackOptions class with the specified target control data.

PostBackOptions(Control, String)

Inicjuje nowe wystąpienie PostBackOptions klasy z określoną kontrolką docelową i danymi argumentów.Initializes a new instance of the PostBackOptions class with the specified target control and argument data.

PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Inicjuje nowe wystąpienie PostBackOptions klasy o określonych wartościach właściwości wystąpienia.Initializes a new instance of the PostBackOptions class with the specified values for the instance's properties.

Właściwości

ActionUrl

Pobiera lub ustawia docelowy adres URL dla ogłaszania zwrotnego strony formularzy sieci Web.Gets or sets the target URL for the postback of a Web Forms page.

Argument

Pobiera lub ustawia opcjonalny argument, który jest przesyłany w zdarzeniu ogłaszania zwrotnego.Gets or sets an optional argument that is transferred in the postback event.

AutoPostBack

Pobiera lub ustawia wartość wskazującą, czy formularz będzie automatycznie ogłaszał zwrot na serwerze w odpowiedzi na akcję użytkownika.Gets or sets a value that indicates whether the form will automatically post back to the server in response to a user action.

ClientSubmit

Pobiera lub ustawia wartość wskazującą, czy zdarzenie ogłaszania zwrotnego powinno wystąpić ze skryptu po stronie klienta.Gets or sets a value indicating whether the postback event should occur from client-side script.

PerformValidation

Pobiera lub ustawia wartość wskazującą, czy przed wystąpieniem zdarzenia ogłaszania zwrotnego jest wymagane Walidacja po stronie klienta.Gets or sets a value indicating whether client-side validation is required before the postback event occurs.

RequiresJavaScriptProtocol

Pobiera lub ustawia wartość wskazującą, czy javascript: prefiks jest generowany dla skryptu po stronie klienta.Gets or sets a value indicating whether the javascript: prefix is generated for the client-side script.

TargetControl

Pobiera obiekt docelowy kontroli, który odbiera zdarzenie ogłaszania zwrotnego.Gets the control target that receives the postback event.

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 na bieżącą kontrolkę.Gets or sets a value indicating whether the postback event should return the page to the current scroll position and return focus to the current control.

ValidationGroup

Pobiera lub ustawia grupę kontrolek, dla których PostBackOptions obiekt powoduje sprawdzenie poprawności po odesłaniu na serwer.Gets or sets the group of controls for which the PostBackOptions object causes validation when it posts back to the server.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też