TreeNodeBinding.NavigateUrlField Eigenschaft

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen des Namens des Felds aus der Datenquelle, das an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird.

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, auf das das TreeNodeBinding Objekt angewendet wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die NavigateUrlField Eigenschaft nicht festgelegt ist.

Attribute: TypeConverterAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die NavigateUrlField Eigenschaft verwendet wird, um anzugeben, welches Attribut eines XML-Elements an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird. Im zweiten Codebeispiel werden XML-Beispieldaten für das erste Codebeispiel bereitgestellt.

Im folgenden Codebeispiel wird veranschaulicht, wie die NavigateUrlField Eigenschaft verwendet wird, um anzugeben, welches Attribut eines XML-Elements an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.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>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 XML-Beispieldaten für das vorangehende Codebeispiel bereitgestellt.

<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 Sie die NavigateUrlField Eigenschaft, um den Feldnamen anzugeben, der an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Wenn die NavigateUrlField Eigenschaft festgelegt ist, zeigt das TreeView Steuerelement einen Link für den Text des Knotens anstelle von Nur-Text an. Optional können Sie die Target Eigenschaft auch so festlegen, dass das Fenster oder rahmen angegeben wird, in dem der verknüpfte Inhalt angezeigt werden soll.

Hinweis

Sie können die NavigateUrlField Eigenschaft selektiv überschreiben, indem Sie die NavigateUrl Eigenschaft jedes Knotens direkt festlegen.

Anstatt die NavigateUrlField Eigenschaft zum Binden der NavigateUrl Eigenschaft TreeNode an ein Feld zu verwenden, können Sie die NavigateUrl Eigenschaft auf einen festen Wert festlegen, indem Sie die NavigateUrl Eigenschaft festlegen.

Hinweis

Wenn die Datenquelle mehrere Felder enthält, müssen Sie zuerst die Depth Eigenschaften oder DataMember eigenschaften festlegen, um eine Bindung an das entsprechende Feld zu erstellen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?