HyperLink.Target Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau menyetel jendela atau bingkai target untuk menampilkan isi halaman Web yang ditautkan ketika HyperLink kontrol diklik.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set

Public Property Target As String

Nilai Properti

String

Jendela atau bingkai target untuk memuat halaman Web yang ditautkan ketika HyperLink kontrol diklik. Nilai harus dimulai dengan huruf dalam rentang hingga z (tidak peka huruf besar/kecil), kecuali untuk nilai khusus yang tercantum dalam tabel berikut, yang dimulai dengan garis bawah.

`_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 yang lebih baru mendukung _search nilai target.

Nilai default adalah string kosong ("").

Atribut: BindableAttribute TypeConverterAttribute

Contoh

Contoh berikut menunjukkan cara mengatur Target properti untuk menentukan jendela atau bingkai untuk menampilkan halaman yang terkait dengan HyperLink kontrol.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

Keterangan

Target Gunakan properti untuk menentukan bingkai atau jendela yang menampilkan halaman Web yang ditautkan ketika HyperLink kontrol diklik. Halaman Web ditentukan dengan mengatur NavigateUrl properti .

Jika properti ini tidak diatur, browser atau jendela dengan fokus disegarkan saat HyperLink kontrol diklik.

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 HyperLink 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 di Visual Studio dan ASP.NET serta Kontrol dan Aksesibilitas ASP.NET.

Berlaku untuk

Bagikan melalui