TreeNodeBinding.ImageUrl 属性

定义

获取或设置显示在应用 TreeNodeBinding 对象的节点旁边的图像的 URL。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

属性值

String

显示在应用 TreeNodeBinding 对象的节点旁边的图像的 URL。The URL to an image that is displayed next to a node to which the TreeNodeBinding object is applied. 必须向The 未设置 ImageUrl 属性。ImageUrl property is not set.

示例

本部分包含两个代码示例。This section contains two code examples. 第一个代码示例演示如何使用 Depth 属性来应用 TreeNodeBinding 特定节点深度的对象。The first code example demonstrates how to use the Depth property to apply a TreeNodeBinding object at a specific node depth. 第二个代码示例提供了第一个代码示例的示例 XML 数据。The second code example provides sample XML data for the first code example.

下面的代码示例演示如何使用 ImageUrl 属性为对象应用到的节点指定自定义图像 TreeNodeBindingThe 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. 若要使此示例正常工作,必须将示例 XML 数据(在此代码示例之后提供)复制到名为 Booklist.xml 的文件中。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>

下面的代码示例提供了前面示例的示例 XML 数据。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>  

注解

TreeView 控件绑定到数据源时,请使用 ImageUrl 属性指定要绑定到对象的属性的自定义图像 ImageUrl TreeNodeWhen 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. 此绑定关系会影响 TreeNode 应用对象的所有对象 TreeNodeBindingThis binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. 只要客户端浏览器支持该格式,该图像将显示在节点旁边,并且可以是任何文件格式 ( .jpg、.gif、.bmp 等等) 。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.

备注

您可以通过直接设置单个节点的属性来覆盖该节点的图像 ImageUrlYou can override the image for an individual node by setting its ImageUrl property directly.

您可以 ImageUrl TreeNode 通过设置属性将对象的属性绑定到数据源的字段,而不是使用此属性将同一图像绑定到每个节点 ImageUrlFieldInstead 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.

使用属性在节点旁显示图像时 ImageUrl ,还应考虑设置 ImageToolTip 属性。When displaying an image next to a node with the ImageUrl property, you should also consider setting the ImageToolTip property. 指定的工具提示文本为辅助技术设备提供了图像说明,可用于使控件更易于访问。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.

此属性的值存储在视图状态中。The value of this property is stored in view state.

适用于

另请参阅