TreeNodeBinding.Target Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví cílové okno nebo rámec, ve kterém se má zobrazit obsah webové stránky, který je přidružen k uzlu, na který TreeNodeBinding je objekt použit.
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };public string Target { get; set; }member this.Target : string with get, setPublic Property Target As StringHodnota vlastnosti
Cílové okno nebo rámeček, ve kterém se má zobrazit propojený obsah webové stránky. Hodnoty musí začínat písmenem v oblasti A až Z (nerozlišují velká a malá písmena), s výjimkou určitých speciálních hodnot, které začínají podtržítkem, jak je znázorněno v následující tabulce.
| Cílová hodnota | Popis |
|---|---|
_blank | Vykreslí obsah v novém okně bez rámců. |
_parent | Vykreslí obsah v nadřazené sadě snímků. |
_search | Vykreslí obsah v podokně hledání. |
_self | Vykreslí obsah v rámci s fokusem. |
_top | Vykreslí obsah v úplném okně bez rámců. |
Poznámka: Zkontrolujte dokumentaci k prohlížeči a zjistěte, jestli _search je hodnota podporovaná. Například Aplikace Microsoft Internet Explorer verze 5.0 a novější podporuje _search cílovou hodnotu.
Výchozí hodnota je prázdný řetězec (""), který aktualizuje okno nebo rámeček s fokusem.
Příklady
Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak pomocí Target vlastnosti určit, že webová stránka, která je přidružena ke kořenovému uzlu, by měla být zobrazena v novém okně. Druhý příklad kódu poskytuje ukázková data XML pro první příklad kódu.
Následující příklad ukazuje, jak pomocí Target vlastnosti určit, že webová stránka přidružená ke kořenovému uzlu by měla být zobrazena v novém okně. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML zadanou po tomto příkladu kódu do souboru s názvem 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>
Následující příklad kódu poskytuje ukázková data XML pro předchozí příklad kódu.
<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>
Poznámky
Při vazbě TreeView ovládacího prvku ke zdroji dat použijte Target vlastnost k určení hodnoty, která se má svázat s Target vlastností objektu TreeNode . Tato relace vazby ovlivňuje všechny TreeNode objekty, na které TreeNodeBinding je objekt použit. Vlastnost Target slouží k určení okna nebo rámce, ve kterém se má zobrazit webový obsah propojený s uzlem při kliknutí na tento uzel.
Poznámka:
Target Nastavení vlastnosti přepíše Target vlastnost TreeView ovládacího prvku pro uzly, na které TreeNodeBinding je objekt použit. Vlastnost můžete selektivně přepsat Target nastavením Target vlastnosti každého uzlu přímo.
Poznámka:
Vlastnost Target se vykreslí jako target atribut. Atribut target elementů anchor není povolen v definici typu dokumentu XHTML 1.1. Nenastavujte Target vlastnost, pokud vykreslený výstup pro TreeNodeBinding ovládací prvek musí být kompatibilní s XHTML 1.1. Další informace naleznete v tématu Standardy XHTML v sadě Visual Studio a ASP.NET.
Při vytváření přístupných webových stránek byste se měli vyhnout použití Target vlastnosti k cílení na jiné okno. Další informace najdete v tématu ASP.NET Přístupnost.
Hodnota této vlastnosti je uložena ve stavu zobrazení.
