ImageButton.PostBackUrl Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Ö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 ImageButton 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

String

Denetim tıklatıldığında geçerli sayfadan gönderilecek Web sayfasının URL'si ImageButton . Varsayılan değer, sayfanın kendisine geri göndermesine neden olan boş bir dizedir ("").

Uygulamalar

PostBackUrl

Öznitelikler: ThemeableAttribute

Ö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 ImageButton 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>ImageButton.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>ImageButton.PostBackUrl Example</h3>

    Enter a value to post:
    <asp:textbox id="TextBox1" 
      runat="Server">
    </asp:textbox>

    <br /><br />

    <asp:imagebutton id="ImageButton1"
      imageUrl=""
      alternatetext="Post back to this page"
      runat="Server">
    </asp:imagebutton>

    <br /><br />

    <asp:imagebutton id="ImageButton2"
      imageUrl=""
      alternatetext="Post value to another page" 
      postbackurl="ImageButton.PostBackUrlPage2cs.aspx" 
      runat="Server">
    </asp:imagebutton>

  </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>ImageButton.PostBackUrl Example</title>
</head>
<body>    
  <form id="form1" runat="server">
    
    <h3>ImageButton.PostBackUrl Example</h3>

    Enter a value to post:
    <asp:textbox id="TextBox1" 
      runat="Server">
    </asp:textbox>

    <br /><br />

    <asp:imagebutton id="PostImageButton"
      imageUrl="Images\PostButton.jpg"
      alternatetext="Post back to this page"
      runat="Server">
    </asp:imagebutton>

    <br /><br />

    <asp:imagebutton id="CrossPostImageButton"
      imageUrl="Images\CrossPostButton.jpg"
      alternatetext="Post value to another page" 
      postbackurl="ImageButton.PostBackUrlPage2vb.aspx" 
      runat="Server">
    </asp:imagebutton>

  </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ğı nulliç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.

Not

Aşağıdaki kod örneği tek dosyalı kod modelini kullanır ve doğrudan arka planda kod dosyasına kopyalandığında düzgün çalışmayabilir. Bu kod örneği.aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. ASP.NET Web Forms Sayfa Kodu Modeli.

<%@ 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>ImageButton.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>ImageButton.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>ImageButton.PostBackUrl Target Page Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>ImageButton.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 ImageButton gerçekleştirmenizi sağlar. PostBackUrl Özelliği, denetim tıklatıldığında göndermek üzere Web sayfasının URL'sine ImageButton ayarlayın. Örneğin, belirtilmesi Page2.aspx denetimi içeren ImageButton sayfanın adresine göndermesine Page2.aspxneden olur. Özellik için PostBackUrl bir değer belirtmezseniz, sayfa kendisine geri gönderir.

Önemli

Sunucu tarafı doğrulamasına sahip denetimlerle 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 PreviousPage'dir. Aşağıdaki Visual Basic 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.

Şunlara uygulanır