TreeNodeBinding.Target Eigenschaft

Definition

Ruft das Zielfenster oder den Zielframe ab, in dem die Webseiteninhalte angezeigt werden sollen, die einem Knoten zugeordnet sind, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt dieses Zielfenster bzw. diesen Zielframe fest.Gets or sets the target window or frame in which to display the Web page content that is associated with a node to which the TreeNodeBinding object is applied.

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 der Zielframe, in dem der verknüpfte Webseiteninhalt angezeigt werden soll.The target window or frame in which to display the linked Web page content. Werte müssen mit einem Buchstaben von A bis Z (ohne Berücksichtigung der Groß- und Kleinschreibung) beginnen, mit Ausnahme der in folgender Tabelle aufgeführten speziellen Werte, die mit einem Unterstrich beginnen:Values must begin with a letter in the range of A through Z (case insensitive), except for certain special values that begin with an underscore, as shown in the following table.

ZielwertTarget value BESCHREIBUNGDescription
_blank Stellt den Inhalt in einem neuen Fenster ohne Frames dar.Renders the content in a new window without frames.
_parent Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.Renders the content in the immediate frameset parent.
_search Gibt den Inhalt im Suchbereich wieder.Renders the content in the search pane.
_self Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.Renders the content in the frame with focus.
_top Stellt den Inhalt im gesamten Fenster ohne Frames dar.Renders the content in the full window without frames.

Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit dem Fokus aktualisiert.The default is an empty string (""), which refreshes the window or frame with focus.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die- Target Eigenschaft verwendet wird, um anzugeben, dass die Webseite, die dem Stamm Knoten zugeordnet ist, in einem neuen Fenster angezeigt werden soll.The first code example demonstrates how to use the Target property to specify that the Web page that is associated with the root node should be displayed in a new window. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitstellt.The second code example provides sample XML data for the first code example.

Im folgenden Beispiel wird veranschaulicht, wie die- Target Eigenschaft verwendet wird, um anzugeben, dass die dem Stamm Knoten zugeordnete Webseite in einem neuen Fenster angezeigt werden soll.The following example demonstrates how to use the Target property to specify that the Web page that is associated with the root node should be displayed in a new window. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Book.xml kopieren.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>

Im folgenden Codebeispiel werden Beispiel-XML-Daten für das vorherige Codebeispiel bereitstellt.The following code example provides sample XML data for the preceding code example.

<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 Target Sie die-Eigenschaft, um den Wert anzugeben, der an die- Target Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the Target property to specify the value to bind to the Target property of a TreeNode object. Diese Bindungs Beziehung wirkt sich TreeNode auf alle Objekte aus, auf die das- TreeNodeBinding Objekt angewendet wird.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. 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.The Target property is used to specify the window or frame in which to display the Web content that is linked to a node when that node is clicked.

Hinweis

Das Festlegen der- Target Eigenschaft überschreibt die- Target Eigenschaft des- TreeView Steuer Elements für die Knoten, auf die das- TreeNodeBinding Objekt angewendet wird.Setting the Target property overrides the Target property of the TreeView control for the nodes to which the TreeNodeBinding object is applied. Sie können die-Eigenschaft selektiv überschreiben, Target indem Sie die- Target Eigenschaft der einzelnen Knoten direkt festlegen.You can selectively override the Target property by setting the Target property of each node directly.

Hinweis

Die Eigenschaft wird als-Attribut gerendert Target target .The Target property renders as a target attribute. Das- target Attribut für- anchor Elemente ist in der XHTML 1,1-Dokumenttyp Definition nicht zulässig.The target attribute on anchor elements is not allowed in the XHTML 1.1 document type definition. Legen Sie die- Target Eigenschaft nicht fest, wenn die gerenderte Ausgabe für das TreeNodeBinding Steuerelement XHTML 1,1-kompatibel sein muss.Do not set the Target property, if the rendered output for the TreeNodeBinding control must be XHTML 1.1 compliant. Weitere Informationen finden Sie unter XHTML-Standards in Visual Studio und ASP.net.For more information, see XHTML Standards in Visual Studio and ASP.NET.

Wenn Sie barrierefreie Webseiten erstellen, sollten Sie die-Eigenschaft nicht verwenden, Target um ein anderes Fenster als Ziel zu verwenden.When creating accessible Web pages, you should avoid using the Target property to target another window. Weitere Informationen finden Sie unter ASP.net Accessibility.For more information, see ASP.NET Accessibility.

Der Wert dieser Eigenschaft wird im Ansichts Zustand gespeichert.The value of this property is stored in view state.

Gilt für:

Siehe auch