Bagikan melalui

HyperLinkField.Target Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur jendela target atau bingkai untuk menampilkan halaman Web yang ditautkan saat hyperlink dalam objek diklik HyperLinkField .

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

Nilai Properti

String

Jendela target atau bingkai untuk memuat halaman Web yang ditautkan saat hyperlink diklik HyperLinkField . Defaultnya adalah string kosong (""), yang menunjukkan bahwa properti ini tidak diatur.

Atribut
TypeConverterAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan Target properti untuk menentukan jendela target untuk menampilkan konten halaman Web yang terkait dengan hyperlink dalam HyperLinkField objek. Halaman Web tertaut ditampilkan di jendela baru saat hyperlink diklik.


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

Keterangan

Target Gunakan properti untuk menentukan jendela atau bingkai untuk menampilkan konten Web yang ditautkan ke hyperlink saat hyperlink tersebut diklik.

Nilai harus dimulai dengan huruf dalam rentang A hingga Z (tidak peka huruf besar/kecil), kecuali untuk nilai khusus yang tercantum dalam tabel berikut, yang masing-masing dimulai dengan garis bawah.

Nilai Deskripsi
_blank Merender konten di jendela baru tanpa bingkai.
_parent Merender konten dalam induk frameset langsung.
_search Merender konten di panel pencarian.
_self Merender konten dalam bingkai dengan fokus.
_top Merender konten di jendela penuh tanpa bingkai.

Catatan

Periksa dokumentasi browser Anda untuk menentukan apakah _search nilai didukung. Misalnya, Microsoft Internet Explorer 5.0 dan versi yang lebih baru mendukung _search nilai target.

Catatan

Properti Target dirender sebagai target atribut. Atribut target pada anchor elemen tidak diizinkan dalam definisi jenis dokumen XHTML 1.1. Jangan atur Target properti jika output yang dirender untuk HyperLinkField objek harus sesuai dengan XHTML 1.1. Untuk informasi selengkapnya, lihat topik Standar XHTML di Visual Studio dan ASP.NET.

Saat membuat halaman Web yang dapat diakses, sangat disarankan agar Anda menghindari penggunaan Target properti untuk menargetkan jendela lain. Untuk informasi selengkapnya, lihat aksesibilitas ASP.NET.

Berlaku untuk

Lihat juga