TreeNodeBinding.NavigateUrlField Eigenschaft

Definition

Ruft den Namen des Felds aus der Datenquelle ab, das an die NavigateUrl-Eigenschaft eines TreeNode-Objekts gebunden werden soll, für das das TreeNodeBinding-Objekt übernommen wird, oder legt diesen fest.Gets or sets the name of the field from the data source to bind to the NavigateUrl property of a TreeNode object to which the TreeNodeBinding object is applied.

public:
 property System::String ^ NavigateUrlField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string NavigateUrlField { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string NavigateUrlField { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.NavigateUrlField : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.NavigateUrlField : string with get, set
Public Property NavigateUrlField As String

Eigenschaftswert

String

Der Name des Felds, das an die NavigateUrl-Eigenschaft eines TreeNode-Objekts gebunden werden soll, für das das TreeNodeBinding-Objekt übernommen wird.The name of the field to bind to the NavigateUrl property of a TreeNode object to which the TreeNodeBinding object is applied. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die NavigateUrlField-Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that the NavigateUrlField property is not set.

Attribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die-Eigenschaft verwendet wird NavigateUrlField , um anzugeben, welches Attribut eines XML-Elements an die-Eigenschaft eines-Objekts gebunden werden soll, NavigateUrl auf das das- TreeNode TreeNodeBinding Objekt angewendet wird.The first code example demonstrates how to use the NavigateUrlField property to specify which attribute of an XML element to bind to the NavigateUrl property of a TreeNode object to which the TreeNodeBinding object is applied. 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 die-Eigenschaft verwendet wird NavigateUrlField , um anzugeben, welches Attribut eines XML-Elements an die-Eigenschaft eines-Objekts gebunden werden soll, NavigateUrl auf das das- TreeNode TreeNodeBinding Objekt angewendet wird.The following code example demonstrates how to use the NavigateUrlField property to specify which attribute of an XML element to bind to the NavigateUrl property of a TreeNode object to which the TreeNodeBinding object is applied. 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 TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField 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" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <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 TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField 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" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <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>

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.

<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 NavigateUrlField Sie die-Eigenschaft, um den Feldnamen anzugeben, der an die- NavigateUrl Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the NavigateUrlField property to specify the field name 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 die- NavigateUrlField Eigenschaft festgelegt ist, zeigt das- TreeView Steuerelement anstelle von nur-Text einen Hyperlink für den Text des Knotens an.When the NavigateUrlField 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, NavigateUrlField indem Sie die- NavigateUrl Eigenschaft der einzelnen Knoten direkt festlegen.You can selectively override the NavigateUrlField property by setting the NavigateUrl property of each node directly.

Anstatt die-Eigenschaft zu verwenden, um NavigateUrlField die- NavigateUrl Eigenschaft eines- TreeNode Objekts an ein-Feld zu binden, können Sie die-Eigenschaft NavigateUrl auf einen festgelegten Wert festlegen, indem Sie die- NavigateUrl Eigenschaft festlegen.Instead of using the NavigateUrlField property to bind the NavigateUrl property of a TreeNode object to a field, you can set the NavigateUrl property to a fixed value by setting the NavigateUrl property.

Hinweis

Wenn die Datenquelle mehrere Felder enthält, müssen Sie zuerst die- Depth Eigenschaft oder die- DataMember Eigenschaft oder beide Eigenschaften festlegen, um Sie an das entsprechende Feld zu binden.If the data source contains multiple fields, you must first set the Depth or DataMember property, or both properties in order to bind to the appropriate field.

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

Gilt für:

Siehe auch