Aracılığıyla paylaş

HyperLinkField.Target Özellik

Tanım

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

Nesnedeki bir köprüye HyperLinkField tıklandığında web sayfasının bağlandığı hedef pencereyi veya çerçeveyi alır veya ayarlar.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String

Özellik Değeri

String

içindeki bir köprüye HyperLinkField tıklandığında bağlanılan Web sayfasının yüklendiği hedef pencere veya çerçeve. Varsayılan, bu özelliğin ayarlanmadığını gösteren boş bir dizedir ("").

Öznitelikler
TypeConverterAttribute

Örnekler

Aşağıdaki kod örneği, bir nesnedeki Target köprüyle HyperLinkField ilişkilendirilmiş Web sayfasının içeriğinin görüntüleneceği bir hedef pencere belirtmek için özelliğinin nasıl kullanılacağını gösterir. Köprü tıklatıldığında bağlantılı Web sayfası yeni bir pencerede görüntülenir.


<%@ 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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Açıklamalar

Köprüye Target tıklandığında köprüye bağlı Web içeriğinin görüntüleneceği pencereyi veya çerçeveyi belirtmek için özelliğini kullanın.

Değerler, aşağıdaki tabloda listelenen ve her biri alt çizgiyle başlayan özel değerler dışında, A ile Z (büyük/küçük harf duyarsız) aralığındaki bir harfle başlamalıdır.

Değer Açıklama
_blank İçeriği çerçeveler olmadan yeni bir pencerede işler.
_parent İçeriği anlık çerçeve kümesi üst öğesinde işler.
_search İçeriği arama bölmesinde işler.
_self Çerçevedeki içeriği odakla işler.
_top İçeriği çerçeveler olmadan tam pencerede işler.

Uyarı

Değerin _search desteklenip desteklenmediğini belirlemek için tarayıcı belgelerinize bakın. Örneğin, Microsoft Internet Explorer 5.0 ve sonraki sürümleri hedef değeri destekler _search .

Uyarı

Target özelliği bir target öznitelik olarak işlenir. target XHTML 1.1 belge türü tanımında öğelerdeki anchor özniteliğine izin verilmez. Nesne için HyperLinkField işlenen çıkışın Target XHTML 1.1 uyumlu olması gerekiyorsa özelliğini ayarlamayın. Daha fazla bilgi için Visual Studio'da XHTML Standartları ve ASP.NET konusuna bakın.

Erişilebilir Web sayfaları oluştururken, başka bir pencereyi hedeflemek için özelliğini kullanmaktan Target kaçınmanız kesinlikle önerilir. Daha fazla bilgi için bkz. erişilebilirlik ASP.NET.

Şunlara uygulanır

Ayrıca bkz.