TreeNodeBinding.NavigateUrl Eigenschaft

Definition

Ruft die URL ab, zu der ein Link hergestellt werden soll, wenn auf einen Knoten geklickt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diese URL fest.Gets or sets the URL to link to when a node to which the TreeNodeBinding object is applied is clicked.

public:
 property System::String ^ NavigateUrl { System::String ^ get(); void set(System::String ^ value); };
public string NavigateUrl { get; set; }
member this.NavigateUrl : string with get, set
Public Property NavigateUrl As String

Eigenschaftswert

String

Die URL, zu der ein Link hergestellt werden soll, wenn auf einen Knoten geklickt wird, auf den das TreeNodeBinding-Objekt angewendet wird.The URL to link to when a node to which the TreeNodeBinding object is applied is clicked. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die NavigateUrl-Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that the NavigateUrl property is not set.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die-Eigenschaft verwendet wird, um die URL anzugeben, mit der eine Verknüpfung hergestellt werden soll, NavigateUrl Wenn auf einen Knoten geklickt wird, auf den das TreeNodeBinding Objekt angewendetThe first code example demonstrates how to use the NavigateUrl property to specify the URL to link to when a node to which the TreeNodeBinding object is applied is clicked. 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 Codebeispiel wird veranschaulicht, wie mit der- NavigateUrl Eigenschaft die URL angegeben wird, mit der eine Verknüpfung hergestellt werden soll, wenn auf einen Knoten geklickt wird, auf den das- TreeNodeBinding Objekt angewendet wirdThe following code example demonstrates how to use the NavigateUrl property to specify the URL to link to when a node to which the TreeNodeBinding object is applied is clicked. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.xml kopieren.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Booklist.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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- properties of a TreeNodeBinding       -->
      <!-- object declaratively.                 -->   
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- properties of a TreeNodeBinding       -->
      <!-- object declaratively.                 -->   
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

Das folgende Codebeispiel enthält Beispiel-XML-Daten für das vorherige Beispiel.The following code example provides sample XML data for the preceding example.

<Books Text="Books List">  
    <Book Text="Book Title One"  
        Value="1"   
        Image="Bookimage1.jpg"  
        ImageToolTip="Book 1 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Book Title 1">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$1.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage1.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
    <Book Text="Book Title Two"  
        Value="2"   
        Image="Bookimage2.jpg"  
        ImageToolTip="Book 2 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Click Me">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$2.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage2.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
</Books>  

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden NavigateUrl Sie die-Eigenschaft, um die URL anzugeben, die an die- NavigateUrl Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the NavigateUrl property to specify the URL to bind to the NavigateUrl 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. Wenn diese Eigenschaft festgelegt ist, TreeView zeigt das Steuerelement anstelle von nur-Text einen Hyperlink für den Text des Knotens an.When this property is set, the TreeView control displays a hyperlink for the text of the node, instead of plain text. Sie können optional auch die- Target Eigenschaft festlegen, um das Fenster oder den Frame anzugeben, in dem der verknüpfte Inhalt angezeigt werden soll.You can also optionally set the Target property to specify the window or frame in which to display the linked content.

Hinweis

Sie können die-Eigenschaft selektiv überschreiben, NavigateUrl indem Sie die- NavigateUrl Eigenschaft der einzelnen Knoten direkt festlegen.You can selectively override the NavigateUrl property by setting the NavigateUrl property of each node directly.

Anstatt die gleiche URL mithilfe der- NavigateUrl Eigenschaft an jeden Knoten zu binden, können Sie die- NavigateUrl Eigenschaft eines- TreeNode Objekts durch Festlegen der-Eigenschaft an ein Feld einer Datenquelle binden NavigateUrlField .Instead of using the NavigateUrl property to bind the same URL to each node, you can bind the NavigateUrl property of a TreeNode object to a field of a data source by setting the NavigateUrlField property.

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

Gilt für:

Siehe auch