Nyelv

TreeNodeBinding.Target Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja azt a célablakot vagy keretet, amelyben megjelenítheti az objektumot alkalmazó csomóponthoz TreeNodeBinding társított weblaptartalmat.

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

Tulajdonság értéke

String

Az a célablak vagy keret, amelyben a hivatkozott weblap tartalma megjeleníthető. Az értékeknek egy betűvel kell kezdődniük az A–Z tartományban (a kis- és nagybetűk nem érzékenek), kivéve az aláhúzásjellel kezdődő speciális értékeket, amint az az alábbi táblázatban látható.

Célérték Leírás
_blank Képkockák nélkül jeleníti meg a tartalmat egy új ablakban.
_parent Megjeleníti a tartalmat az azonnali keretkészlet szülőjében.
_search Megjeleníti a tartalmat a keresési panelen.
_self Fókuszban jeleníti meg a keret tartalmát.
_top Képkockák nélkül jeleníti meg a tartalmat a teljes ablakban.

Megjegyzés: Ellenőrizze a böngésző dokumentációjában, hogy az _search érték támogatott-e. Például Microsoft Internet Explorer 5.0-s és újabb verziója támogatja a _search célértéket.

Az alapértelmezett érték egy üres sztring (""), amely fókuszban frissíti az ablakot vagy a keretet.

Példák

Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan használhatja a Target tulajdonságot annak megadására, hogy a gyökércsomóponthoz társított weblapnak egy új ablakban kell megjelennie. A második példa xml-mintaadatokat biztosít az első kód példájához.

Az alábbi példa bemutatja, hogyan használható a Target tulajdonság arra, hogy a gyökércsomóponthoz társított weblap megjelenjen egy új ablakban. Ahhoz, hogy ez a példa megfelelően működjön, a példakód után megadott XML-mintaadatokat egy Book.xmlnevű fájlba kell másolnia.


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

Az alábbi példakód az előző kódmintához tartozó XML-mintaadatokat tartalmazza.

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

Megjegyzések

Ha a TreeView vezérlő egy adatforráshoz van kötve, a Target tulajdonság használatával adja meg az objektum tulajdonságához TargetTreeNode kötéshez szükséges értéket. Ez a kötési kapcsolat minden TreeNode olyan objektumra hatással van, amelyre az TreeNodeBinding objektumot alkalmazza. A Target tulajdonság azt az ablakot vagy keretet adja meg, amelyben a csomóponthoz csatolt webes tartalom jelenjen meg, amikor a csomópontra kattint.

Note

A Target tulajdonság beállítása felülbírálja azoknak a Target csomópontoknak a TreeView vezérlőjének tulajdonságát, amelyekre az TreeNodeBinding objektumot alkalmazza. Az egyes csomópontok tulajdonságának közvetlen beállításával szelektíven felülbírálhatja Target a Target tulajdonságot.

Note

A Target tulajdonság attribútumként target jelenik meg. Az target elemek attribútuma anchor nem engedélyezett az XHTML 1.1 dokumentumtípus-definícióban. Ne állítsa be a Target tulajdonságot, ha a vezérlő renderelt kimenetének TreeNodeBinding XHTML 1.1-es megfelelőnek kell lennie. További információ: XHTML-szabványok Visual Studio és ASP.NET.

Akadálymentes weblapok létrehozásakor ne használja a Target tulajdonságot egy másik ablak megcélzására. További információ: ASP.NET Kisegítő lehetőségek.

Ennek a tulajdonságnak az értéke megtekintési állapotban van tárolva.

A következőre érvényes:

Lásd még