Button.PostBackUrl Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Denetim tıklatıldığında geçerli sayfadan gönderilecek sayfanın URL'sini Button alır veya ayarlar.
public:
virtual property System::String ^ PostBackUrl { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string PostBackUrl { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.PostBackUrl : string with get, set
Public Overridable Property PostBackUrl As String
Özellik Değeri
Denetim tıklatıldığında geçerli sayfadan gönderilecek Web sayfasının URL'si Button . Varsayılan değer boş bir dizedir (""), bu da sayfanın kendisine geri göndermesine neden olur.
Uygulamalar
- Öznitelikler
Örnekler
Aşağıdaki kod örneği, çapraz sayfa gönderisi PostBackUrl gerçekleştirmek için özelliğinin nasıl kullanılacağını gösterir. Kullanıcı denetime Button tıkladığında, sayfa metin kutusuna girilen değeri özelliği tarafından belirtilen hedef sayfaya PostBackUrl gönderir. Bu örneği çalıştırmak için, bu kod örneğiyle aynı dizinde hedef sayfa için de bir dosya oluşturmanız gerekir. Hedef sayfanın kodu bir sonraki örnekte verilmiştir.
<%@ page language="C#" %>
<!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>Button.PostBackUrl Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.PostBackUrl Example</h3>
Enter a value to post:
<asp:textbox id="TextBox1"
runat="Server">
</asp:textbox>
<br /><br />
<asp:button id="Button1"
text="Post back to this page"
runat="Server">
</asp:button>
<br /><br />
<asp:button id="Button2"
text="Post value to another page"
postbackurl="Button.PostBackUrlPage2cs.aspx"
runat="Server">
</asp:button>
</form>
</body>
</html>
<%@ page language="VB" %>
<!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>Button.PostBackUrl Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.PostBackUrl Example</h3>
Enter a value to post:
<asp:textbox id="TextBox1"
runat="Server">
</asp:textbox>
<br /><br />
<asp:button id="Button1"
text="Post back to this page"
runat="Server">
</asp:button>
<br /><br />
<asp:button id="Button2"
text="Post value to another page"
postbackurl="Button.PostBackUrlPage2vb.aspx"
runat="Server">
</asp:button>
</form>
</body>
</html>
Aşağıdaki kod örneği, özelliğini kullanarak başka bir sayfadan Page.PreviousPage gönderilen bir değere erişmek için özelliğinin PostBackUrl nasıl kullanılacağını gösterir. Bu sayfa, önceki sayfadan gönderilen dizeyi alır ve kullanıcıya görüntüler. Bu kod örneğini doğrudan çalıştırmayı denerseniz, alanın değeri text
olacağı null
için bir hata alırsınız. Bunun yerine bu kodu kullanarak bir hedef sayfa oluşturun ve dosyayı önceki örnekteki kodla aynı dizine yerleştirin. Dosyanın adı, önceki örnekte özellik için belirtilen değere PostBackUrl karşılık gelir. Önceki örnekteki kodu çalıştırdığınızda, çapraz sayfa gönderisi gerçekleştiğinde bu sayfa otomatik olarak yürütülür.
Önemli
Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load (object sender, System.EventArgs e)
{
string text;
// Get the value of TextBox1 from the page that
// posted to this page.
text = ((TextBox)PreviousPage.FindControl("TextBox1")).Text;
// Check for an empty string.
if (text != "")
PostedLabel.Text = "The string posted from the previous page is "
+ text + ".";
else
PostedLabel.Text = "An empty string was posted from the previous page.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Button.PostBackUrl Target Page Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.PostBackUrl Target Page Example</h3>
<br />
<asp:label id="PostedLabel"
runat="Server">
</asp:label>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Dim text As String
' Get the value of TextBox1 from the page that posted
' to this page.
text = CType((PreviousPage.FindControl("TextBox1")), TextBox).Text
' Check for an empty string.
If Not (text = "") Then
PostedLabel.Text = "The string posted from the previous page is " _
& text & "."
Else
PostedLabel.Text = "An empty string was posted from the previous page."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Button.PostBackUrl Target Page Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.PostBackUrl Target Page Example</h3>
<br />
<asp:label id="PostedLabel"
runat="Server">
</asp:label>
</form>
</body>
</html>
Açıklamalar
özelliği, PostBackUrl denetimi kullanarak çapraz sayfa gönderisi Button gerçekleştirmenizi sağlar.
Not
Yalnızca doğru belirtilen yollar bu özellik ile çalışır. Örneğin, göreli yollar (Test/default.aspx
), mutlak yollar (https://localhost/WebApp/default.aspx
) ve sanal (~\Test\default.aspx
) düzgün çalışır. "/Test/default.aspx" veya "\Test\default.aspx" gibi yanlış biçimlendirilmiş yollar çalışmaz. Doğru yolları oluşturma hakkında bir tartışma için bkz. ASP.NET Web Projesi Yolları .
PostBackUrl Özelliği, denetim tıklatıldığında göndermek üzere Web sayfasının URL'sine Button ayarlayın. Örneğin, belirtilmesi Page2.aspx
denetimi içeren Button sayfanın adresine göndermesine Page2.aspx
neden olur. Özellik için PostBackUrl bir değer belirtmezseniz, sayfa kendisine geri gönderir.
Önemli
Sunucu tarafı doğrulama ile denetimler içeren bir çapraz sayfa geri göndermesi gerçekleştirirken, geri göndermeyi işlemeden önce sayfanın IsValid özelliğinin olup olmadığını true
denetlemeniz gerekir. Çapraz sayfa geri gönderme durumunda denetlenecek sayfa şeklindedir PreviousPage. Aşağıdaki VB kodu bunun nasıl yapıldığını gösterir:
Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
If Page.PreviousPage.IsValid Then
' Handle the post back
Else
Response.Write("Invalid")
End If
End Sub
Çapraz sayfa deftere nakil teknikleri hakkında daha fazla bilgi için bkz. ASP.NET Web Forms'da Çapraz Sayfa Deftere Nakil.
Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . temalar ve dış görünümler ASP.NET.