TreeNodeBinding.NavigateUrlField Eigenschaft

Referenz

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.

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.

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. 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 mithilfe der NavigateUrlField Eigenschaft angegeben wird, welches Attribut eines XML-Elements an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll, an das das TreeNodeBinding Objekt angewendet wird. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der NavigateUrlField Eigenschaft angegeben wird, welches Attribut eines XML-Elements an die NavigateUrl Eigenschaft eines TreeNode Objekts gebunden werden soll, an das das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen 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 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 Steuerelement an eine Datenquelle gebunden ist, geben Sie mithilfe TreeView der NavigateUrlField Eigenschaft den Feldnamen an die NavigateUrl Eigenschaft eines TreeNode Objekts an. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Wenn die NavigateUrlField Eigenschaft festgelegt wird, zeigt das TreeView Steuerelement anstelle von Nur-Text einen Link für den Text des Knotens an. Sie können die Target Eigenschaft auch optional festlegen, um das Fenster oder den Rahmen anzugeben, 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 Eigenschaft zum Binden der NavigateUrlField NavigateUrl Eigenschaft an ein TreeNode 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 Eigenschaft DataMember oder beide Eigenschaften festlegen, um an das entsprechende Feld zu binden.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Freigeben über