TreeNodeBinding.Target Properti
Definisi
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 mengatur jendela target atau bingkai untuk menampilkan isi halaman Web yang terkait dengan simpul tempat TreeNodeBinding objek diterapkan.
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String
Nilai Properti
Jendela target atau bingkai untuk menampilkan isi halaman Web yang ditautkan. Nilai harus dimulai dengan huruf dalam rentang A hingga Z (tidak peka huruf besar/kecil), kecuali untuk nilai khusus tertentu yang dimulai dengan garis bawah, seperti yang diperlihatkan dalam tabel berikut.
Nilai target | 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
nilainya didukung. Misalnya, Microsoft Internet Explorer versi 5.0 dan yang lebih baru mendukung _search
nilai target.
Defaultnya adalah string kosong (""), yang me-refresh jendela atau bingkai dengan fokus.
Contoh
Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan Target properti untuk menentukan bahwa halaman Web yang terkait dengan simpul akar harus ditampilkan di jendela baru. Contoh kode kedua menyediakan contoh data XML untuk contoh kode pertama.
Contoh berikut menunjukkan cara menggunakan Target properti untuk menentukan bahwa halaman Web yang terkait dengan simpul akar harus ditampilkan di jendela baru. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data XML sampel, yang disediakan setelah contoh kode ini, ke file bernama Book.xml.
<%@ 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>TreeNodeBinding Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding Target Example</h3>
<!-- Clicking the root node will navigate -->
<!-- the user to another page. Because the -->
<!-- Target property is set to "_blank", -->
<!-- the linked page is displayed in a new -->
<!-- window. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
Depth="0"
TextField="Title"
NavigateUrl="~\Page1.aspx"
Target="_blank"/>
<asp:TreeNodeBinding DataMember="Chapter"
Depth="1"
TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix"
Depth="1"
TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</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>TreeNodeBinding Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding Target Example</h3>
<!-- Clicking the root node will navigate -->
<!-- the user to another page. Because the -->
<!-- Target property is set to "_blank", -->
<!-- the linked page is displayed in a new -->
<!-- window. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
Depth="0"
TextField="Title"
NavigateUrl="~\Page1.aspx"
Target="_blank"/>
<asp:TreeNodeBinding DataMember="Chapter"
Depth="1"
TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix"
Depth="1"
TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
Contoh kode berikut menyediakan contoh data XML untuk contoh kode sebelumnya.
<Book Title="Book Title">
<Chapter Heading="Chapter 1">
<Section Heading="Section 1">
</Section>
<Section Heading="Section 2">
</Section>
</Chapter>
<Chapter Heading="Chapter 2">
<Section Heading="Section 1">
</Section>
</Chapter>
<Appendix Heading="Appendix A">
</Appendix>
</Book>
Keterangan
TreeView Saat kontrol terikat ke sumber data, gunakan Target properti untuk menentukan nilai yang akan diikat ke Target properti TreeNode objek. Hubungan pengikatan ini mempengaruhi semua TreeNode objek tempat TreeNodeBinding objek diterapkan. Properti Target digunakan untuk menentukan jendela atau bingkai untuk menampilkan konten Web yang ditautkan ke simpul ketika simpul tersebut diklik.
Catatan
Target Mengatur properti akan mengambil Target alih properti TreeView kontrol untuk simpul tempat TreeNodeBinding objek diterapkan. Anda dapat secara selektif mengambil alih Target properti dengan mengatur Target properti setiap simpul secara langsung.
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 TreeNodeBinding kontrol harus sesuai dengan XHTML 1.1. Untuk informasi selengkapnya, lihat Standar XHTML di Visual Studio dan ASP.NET.
Saat membuat halaman Web yang dapat diakses, Anda harus menghindari penggunaan properti untuk menargetkan Target jendela lain. Untuk informasi selengkapnya, lihat aksesibilitas ASP.NET.
Nilai properti ini disimpan dalam status tampilan.