Freigeben über

TreeNodeBinding.Target Eigenschaft

Definition

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

Ruft das Zielfenster oder den Zielrahmen ab, in dem der Webseiteninhalt angezeigt werden soll, der einem Knoten zugeordnet ist, auf den das TreeNodeBinding Objekt angewendet wird, oder legt diesen fest.

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

Eigenschaftswert

String

Das Zielfenster oder -frame, in dem der verknüpfte Webseiteninhalt angezeigt werden soll. Werte müssen mit einem Buchstaben im Bereich von A bis Z beginnen (Groß-/Kleinschreibung wird nicht beachtet), mit Ausnahme bestimmter spezieller Werte, die mit einem Unterstrich beginnen, wie in der folgenden Tabelle dargestellt.

Zielwert Beschreibung
_blank Rendert den Inhalt in einem neuen Fenster ohne Frames.
_parent Rendert den Inhalt im übergeordneten Direktframeet.
_search Rendert den Inhalt im Suchbereich.
_self Rendert den Inhalt im Frame mit Fokus.
_top Rendert den Inhalt im vollständigen Fenster ohne Frames.

Hinweis: Überprüfen Sie ihre Browserdokumentation, um zu ermitteln, ob der _search Wert unterstützt wird. Microsoft Internet Explorer, Version 5.0 und höher, unterstützt z. B. den _search Zielwert.

Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit Fokus aktualisiert.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die Target Eigenschaft verwendet wird, um anzugeben, dass die Webseite, die dem Stammknoten zugeordnet ist, in einem neuen Fenster angezeigt werden soll. Im zweiten Codebeispiel werden XML-Beispieldaten für das erste Codebeispiel bereitgestellt.

Im folgenden Beispiel wird veranschaulicht, wie die Target Eigenschaft verwendet wird, um anzugeben, dass die Webseite, die dem Stammknoten zugeordnet ist, in einem neuen Fenster angezeigt werden soll. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Book.xmlkopieren.


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

Im folgenden Codebeispiel werden XML-Beispieldaten für das vorangehende Codebeispiel bereitgestellt.

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

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die Target Eigenschaft, um den Wert anzugeben, der an die Target Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Die Target Eigenschaft wird verwendet, um das Fenster oder den Frame anzugeben, in dem der Webinhalt angezeigt werden soll, der mit einem Knoten verknüpft ist, wenn auf diesen Knoten geklickt wird.

Hinweis

Durch Festlegen der Target Eigenschaft wird die Target Eigenschaft des TreeView Steuerelements für die Knoten außer Kraft gesetzt, auf die das TreeNodeBinding Objekt angewendet wird. Sie können die Target Eigenschaft selektiv überschreiben, indem Sie die Target Eigenschaft jedes Knotens direkt festlegen.

Hinweis

Die Target Eigenschaft wird als target Attribut gerendert. Das target Attribut für anchor Elemente ist in der XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Target Eigenschaft nicht fest, wenn die gerenderte Ausgabe für das TreeNodeBinding Steuerelement XHTML 1.1 kompatibel sein muss. Weitere Informationen finden Sie unter XHTML Standards in Visual Studio und ASP.NET.

Beim Erstellen barrierefreier Webseiten sollten Sie die Verwendung der Target Eigenschaft vermeiden, um ein anderes Fenster zu verwenden. Weitere Informationen finden Sie unter ASP.NET Barrierefreiheit.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen