PostBackOptions Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

Geri gönderme olayını başlatmak için istemci tarafı JavaScript'in nasıl oluşturulduğunu belirtir.

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
Devralma
Object
PostBackOptions

Örnekler

Aşağıdaki kod örneği, denetimin Button bir geri gönderme olayına neden olmasına izin verecek bir HyperLink denetim için istemci tarafı betiği oluşturmak üzere bir denetimin HyperLink olayını kullanırOnClick. Nesnenin ActionUrl myPostBackOptions özelliği "Page2.aspx" olarak ayarlandığından, geri gönderme işlemi Web Forms sayfasını burada sağlanmayan "Page2.aspx" adlı başka bir sayfaya gönderir. Bu örneği kullanmak için projenize veya dizininize "Page2.aspx" adlı başka bir Web sayfası eklemeniz gerekir.

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

Aşağıdaki kod örneği, önceki arka planda kod dosyasını çalıştırmak için kullanılabilecek bir Web sayfasıdır.

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

Açıklamalar

sınıfı, denetimlerin PostBackOptions bir geri gönderme olayı başlatan istemci tarafı betiğini yaymasına izin verir. sınıfı ayrıca PostBackOptions özelliği aracılığıyla geri gönderme olayını başlatan denetime TargetControl bir başvuru sağlar. Geri gönderme olayı, yöntemine geçirilen ClientScriptManager.GetPostBackEventReference nesnede PostBackOptions belirtilen seçeneklere göre oluşturulur.

Normalde sunucuya geri gönderme işlemi Gönder düğmesi veya Görüntü düğmesi gibi öğeler tarafından başlatılır. Ancak istemci tarafı JavaScript'i yayarak farklı denetimler bir geri gönderme olayı başlatabilir.

Oluşturucular

PostBackOptions(Control)

Belirtilen hedef denetim verileriyle sınıfının yeni bir örneğini PostBackOptions başlatır.
PostBackOptions(Control, String)

Belirtilen hedef denetimi ve bağımsız değişken verileriyle sınıfının yeni bir örneğini PostBackOptions başlatır.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Örneğin özellikleri için belirtilen değerlerle sınıfının yeni bir örneğini PostBackOptions başlatır.

Özellikler

ActionUrl

Web Forms sayfasının geri göndermesi için hedef URL'yi alır veya ayarlar.
Argument

Geri gönderme olayında aktarılan isteğe bağlı bir bağımsız değişkeni alır veya ayarlar.
AutoPostBack

Formun bir kullanıcı eylemine yanıt olarak otomatik olarak sunucuya geri gönderip göndermeyeceğini belirten bir değer alır veya ayarlar.
ClientSubmit

Geri gönderme olayının istemci tarafı betiğinden oluşup oluşmayacağını belirten bir değer alır veya ayarlar.
PerformValidation

Geri gönderme olayı gerçekleşmeden önce istemci tarafı doğrulamasının gerekli olup olmadığını belirten bir değer alır veya ayarlar.
RequiresJavaScriptProtocol

ön ekin javascript: istemci tarafı betiği için oluşturulup oluşturulmadığını belirten bir değer alır veya ayarlar.
TargetControl

Geri gönderme olayını alan denetim hedefini alır.
TrackFocus

Geri gönderme olayının sayfayı geçerli kaydırma konumuna döndürmesi ve odağı geçerli denetime döndürmesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.
ValidationGroup

Nesnenin sunucuya geri gönderildiğinde doğrulamaya PostBackOptions neden olduğu denetim grubunu alır veya ayarlar.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.