Aracılığıyla paylaş

HyperLinkField.Target Özellik

  • Başvuru

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

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 değer, 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şkili Web sayfasının içeriğinin görüntüleneceği hedef pencereyi 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ü tıklatıldığında Target 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.

Aşağıdaki tabloda listelenen ve her biri alt çizgiyle başlayan özel değerler dışında, değerler A ile Z (büyük/küçük harfe duyarlı olmayan) 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.

Not

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

Not

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 işlenen çıkışın TargetHyperLinkField 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.