PostBackOptions Osztály

Definíció

Névtér:: System.Web.UI

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Megadja, hogyan jön létre az ügyféloldali JavaScript a postback esemény elindításához.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Öröklődés: Object
PostBackOptions

Példák

Az alábbi példakód OnClick egy Button vezérlő eseményével hoz létre ügyféloldali szkriptet egy HyperLink olyan vezérlőhöz, amely lehetővé teszi, hogy a HyperLink vezérlő visszavételi eseményt okozzon. Mivel az ActionUrlmyPostBackOptions objektum tulajdonsága "Page2.aspx" értékre van állítva, a postback a Webes űrlapok lapot egy másik, "Page2.aspx" nevű lapra helyezi, amely itt nincs megadva. A példa használatához egy "Page2.aspx" nevű weblapot kell hozzáadnia a projekthez vagy könyvtárhoz.

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

Az alábbi példakód egy weblap, amely az előző kód mögötti fájl futtatására használható.

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

Megjegyzések

Az PostBackOptions osztály lehetővé teszi, hogy a vezérlők olyan ügyféloldali szkriptet bocsátanak ki, amely utólagos eseményt kezdeményez. Az PostBackOptions osztály hivatkozik arra a vezérlőre is, amely a tulajdonságon keresztül indította el a visszavételi eseményt TargetControl . A visszavételi esemény a metódusnak PostBackOptions átadott objektumban ClientScriptManager.GetPostBackEventReference megadott beállítások alapján jön létre.

A kiszolgálóra való visszavételt általában olyan elemek kezdeményezik, mint a Küldés gomb vagy a Kép gomb. Az ügyféloldali JavaScript kibocsátásával azonban a különböző vezérlők visszavételi eseményt kezdeményezhetnek.

Konstruktorok

Name	Description
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Inicializálja az PostBackOptions osztály új példányát a példány tulajdonságainak megadott értékeivel.
PostBackOptions(Control, String)	Inicializálja az osztály új példányát PostBackOptions a megadott célvezérlő és argumentumadatokkal.
PostBackOptions(Control)	Inicializálja az osztály új példányát PostBackOptions a megadott célvezérlő adatokkal.

Tulajdonságok

Name	Description
ActionUrl	Lekéri vagy beállítja a weblapok utáni visszavétel cél URL-címét.
Argument	Lekéri vagy beállít egy nem kötelező argumentumot, amely a visszavétel utáni eseményben lesz átadva.
AutoPostBack	Lekéri vagy beállít egy értéket, amely jelzi, hogy az űrlap automatikusan visszakerül-e a kiszolgálóra egy felhasználói műveletre válaszul.
ClientSubmit	Lekéri vagy beállít egy értéket, amely jelzi, hogy a visszavételi eseménynek ügyféloldali szkriptből kell-e történnie.
PerformValidation	Lekéri vagy beállít egy értéket, amely jelzi, hogy az ügyféloldali ellenőrzés szükséges-e a postback esemény bekövetkezése előtt.
RequiresJavaScriptProtocol	Lekéri vagy beállít egy értéket, amely jelzi, hogy az `javascript:` előtag létrejön-e az ügyféloldali szkripthez.
TargetControl	Lekéri a visszavételi eseményt fogadó vezérlőcélt.
TrackFocus	Lekéri vagy beállít egy értéket, amely jelzi, hogy a visszavételi eseménynek vissza kell-e adnia az oldalt az aktuális görgetési pozícióba, és vissza kell-e állítania a fókuszt az aktuális vezérlőre.
ValidationGroup	Lekéri vagy beállítja azokat a vezérlőcsoportokat, amelyek esetében az PostBackOptions objektum érvényesítést okoz, amikor visszakerül a kiszolgálóra.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

A következőre érvényes:

Lásd még

GetPostBackEventReference(PostBackOptions)

Visszajelzés

Hasznosnak találta ezt az oldalt?