TreeNodeBinding.Target Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u het doelvenster of het doelframe op waarin de webpagina-inhoud wordt weergegeven die is gekoppeld aan een knooppunt waarop het TreeNodeBinding object wordt toegepast.

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

Waarde van eigenschap

String

Het doelvenster of frame waarin de inhoud van de gekoppelde webpagina wordt weergegeven. Waarden moeten beginnen met een letter in het bereik van A tot en met Z (hoofdlettergevoelig), met uitzondering van bepaalde speciale waarden die beginnen met een onderstrepingsteken, zoals wordt weergegeven in de volgende tabel.

Doelwaarde Beschrijving
_blank Geeft de inhoud weer in een nieuw venster zonder frames.
_parent Geeft de inhoud weer in de bovenliggende frameset.
_search Geeft de inhoud weer in het zoekvenster.
_self Geeft de inhoud in het frame weer met de focus.
_top Geeft de inhoud weer in het volledige venster zonder frames.

Opmerking: Controleer de browserdocumentatie om te bepalen of de _search waarde wordt ondersteund. Microsoft Internet Explorer versie 5.0 en hoger ondersteunt bijvoorbeeld de doelwaarde _search.

De standaardwaarde is een lege tekenreeks (""), waarmee het venster of frame met focus wordt vernieuwd.

Voorbeelden

Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u de Target eigenschap gebruikt om op te geven dat de webpagina die is gekoppeld aan het hoofdknooppunt in een nieuw venster moet worden weergegeven. Het tweede codevoorbeeld bevat voorbeeld-XML-gegevens voor het eerste codevoorbeeld.

In het volgende voorbeeld ziet u hoe u de Target eigenschap gebruikt om op te geven dat de webpagina die is gekoppeld aan het hoofdknooppunt in een nieuw venster moet worden weergegeven. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens kopiëren, die na dit codevoorbeeld zijn opgegeven, naar een bestand met de naam 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>

Het volgende codevoorbeeld bevat voorbeeld-XML-gegevens voor het voorgaande codevoorbeeld.

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

Opmerkingen

Wanneer het TreeView besturingselement is gebonden aan een gegevensbron, gebruikt u de Target eigenschap om de waarde op te geven die moet worden gekoppeld aan de Target eigenschap van een TreeNode object. Deze bindingsrelatie is van invloed op alle TreeNode objecten waarop het TreeNodeBinding object wordt toegepast. De Target eigenschap wordt gebruikt om het venster of frame op te geven waarin de webinhoud wordt weergegeven die is gekoppeld aan een knooppunt wanneer op dat knooppunt wordt geklikt.

Note

Als u de Target eigenschap instelt, wordt de Target eigenschap van het TreeView besturingselement overschreven voor de knooppunten waarop het TreeNodeBinding object wordt toegepast. U kunt de Target eigenschap selectief overschrijven door de Target eigenschap van elk knooppunt rechtstreeks in te stellen.

Note

De Target eigenschap wordt weergegeven als een target kenmerk. Het target kenmerk voor anchor elementen is niet toegestaan in de definitie van het XHTML 1.1-documenttype. Stel de Target eigenschap niet in als de weergegeven uitvoer voor het TreeNodeBinding besturingselement XHTML 1.1 compatibel moet zijn. Zie XHTML Standards in Visual Studio en ASP.NET voor meer informatie.

Wanneer u toegankelijke webpagina's maakt, moet u voorkomen dat u de Target eigenschap gebruikt om een ander venster te richten. Zie ASP.NET Accessibility voor meer informatie.

De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.

Van toepassing op

Zie ook