TreeNodeBinding.ImageUrl Eigenschaft

Definition

Ruft die URL für ein Bild ab, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diese URL fest.Gets or sets the URL to an image that is displayed next to a node to which the TreeNodeBinding object is applied.

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

Eigenschaftswert

String

Die URL für ein Bild, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird.The URL to an image that is displayed next to a node to which the TreeNodeBinding object is applied. DieThe Die ImageUrl-Eigenschaft ist nicht festgelegt.ImageUrl 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 Depth , um ein- TreeNodeBinding Objekt in einer bestimmten Knoten Tiefe anzuwenden.The first code example demonstrates how to use the Depth property to apply a TreeNodeBinding object at a specific node depth. 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 ImageUrl , um ein benutzerdefiniertes Image für einen Knoten anzugeben, auf den das- TreeNodeBinding Objekt angewendet wird.The following code example demonstrates how to use the ImageUrl property to specify a custom image for a node 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 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 ImageUrl Sie die-Eigenschaft, um ein benutzerdefiniertes Bild anzugeben, das an die ImageUrl Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the ImageUrl property to specify a custom image to bind to the ImageUrl 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. Das Bild wird neben einem Knoten angezeigt und kann ein beliebiges Dateiformat aufweisen (JPG, GIF, BMP usw.), solange der Client Browser dieses Format unterstützt.The image is displayed next to a node and can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client browser supports that format.

Hinweis

Sie können das Abbild für einen einzelnen Knoten überschreiben, indem Sie seine- ImageUrl Eigenschaft direkt festlegen.You can override the image for an individual node by setting its ImageUrl property directly.

Anstatt diese Eigenschaft zu verwenden, um das gleiche Bild an jeden Knoten zu binden, können Sie die- ImageUrl Eigenschaft eines- TreeNode Objekts an ein Feld einer Datenquelle binden, indem Sie die- ImageUrlField Eigenschaft festlegen.Instead of using this property to bind the same image to each node, you can bind the ImageUrl property of a TreeNode object to a field of a data source by setting the ImageUrlField property.

Beim Anzeigen eines Bilds neben einem Knoten mit der- ImageUrl Eigenschaft sollten Sie auch das Festlegen der-Eigenschaft in Erwägung gezogen ImageToolTip .When displaying an image next to a node with the ImageUrl property, you should also consider setting the ImageToolTip property. Der QuickInfo-Text, den Sie angeben, bietet Hilfstechnologiegeräte mit einer Beschreibung des Bilds, das verwendet werden kann, um das Steuerelement leichter zugänglich zu machen.The ToolTip text that you specify provides Assistive Technology devices with a description of the image that can be used to make the control more accessible.

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

Gilt für:

Siehe auch