TreeNodeBinding.Target Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger målfönstret eller ramen där webbsidans innehåll som är associerat med en nod som TreeNodeBinding objektet ska tillämpas på ska visas.

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

Egenskapsvärde

String

Målfönstret eller ramen där det länkade webbplatsinnehållet ska visas. Värdena måste börja med en bokstav i intervallet A till Z (skiftlägesokänsligt), förutom vissa specialvärden som börjar med ett understreck, som visas i följande tabell.

Målvärde Beskrivning
_blank Renderar innehållet i ett nytt fönster utan bildrutor.
_parent Renderar innehållet i den överordnade ramuppsättningen.
_search Renderar innehållet i sökfönstret.
_self Renderar innehållet i ramen med fokus.
_top Renderar innehållet i det fullständiga fönstret utan bildrutor.

Obs! Kontrollera webbläsarens dokumentation för att avgöra om _search värdet stöds. Till exempel stöder Microsoft Internet Explorer version 5.0 och senare _search målvärdet.

Standardvärdet är en tom sträng (""), som uppdaterar fönstret eller ramen med fokus.

Exempel

Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder Target egenskapen för att ange att webbsidan som är associerad med rotnoden ska visas i ett nytt fönster. Det andra kodexemplet innehåller XML-exempeldata för det första kodexemplet.

I följande exempel visas hur du använder Target egenskapen för att ange att webbsidan som är associerad med rotnoden ska visas i ett nytt fönster. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata, som tillhandahålls efter det här kodexemplet, till en fil med namnet 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>

Följande kodexempel innehåller XML-exempeldata för föregående kodexempel.

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

Kommentarer

När kontrollen TreeView är bunden till en datakälla använder du Target egenskapen för att ange värdet för att binda till Target egenskapen för ett TreeNode objekt. Den här bindningsrelationen TreeNode påverkar alla TreeNodeBinding objekt som objektet tillämpas på. Egenskapen Target används för att ange det fönster eller den ram där webbinnehållet som är länkat till en nod ska visas när noden klickas.

Note

Om du Target anger egenskapen åsidosätts Target egenskapen TreeView för kontrollen för de noder som TreeNodeBinding objektet tillämpas på. Du kan selektivt åsidosätta Target egenskapen genom att ange egenskapen för Target varje nod direkt.

Note

Egenskapen Target återges som ett target attribut. Attributet target för anchor element tillåts inte i XHTML 1.1-dokumenttypens definition. Ange Target inte egenskapen om de renderade utdata för TreeNodeBinding kontrollen måste vara XHTML 1.1-kompatibla. Mer information finns i XHTML-standarder i Visual Studio och ASP.NET.

När du skapar tillgängliga webbsidor bör du undvika att använda egenskapen Target för att rikta in dig på ett annat fönster. Mer information finns i ASP.NET Accessibility.

Värdet för den här egenskapen lagras i visningstillstånd.

Gäller för

Se även