Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

TreeNode.ImageUrl-Eigenschaft

Ruft den URL zu einem Bild ab, das neben dem Knoten angezeigt wird, oder legt diesen URL fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public string ImageUrl { get; set; }
/** @property */
public String get_ImageUrl ()

/** @property */
public void set_ImageUrl (String value)

public function get ImageUrl () : String

public function set ImageUrl (value : String)

Nicht zutreffend.

Eigenschaftenwert

Der URL zu einem benutzerdefinierten Bild, das neben dem Knoten angezeigt wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt wurde.

Verwenden Sie die ImageUrl-Eigenschaft, um ein benutzerdefiniertes Bild für den aktuellen Knoten im TreeView-Steuerelement anzugeben. Dieses Bild wird neben dem Knoten angezeigt und kann in einem beliebigen Dateiformat (JPG, GIF, BMP usw.) vorliegen, sofern dieses Format vom Browser des Clients unterstützt wird.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Im folgenden Codebeispiel wird veranschaulicht, wie mit der ImageUrl-Eigenschaft ein benutzerdefiniertes Bild für einen Knoten angegeben wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die nachfolgenden XML-Beispieldaten in eine Datei mit dem Namen Book.xml kopieren.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Data_Bound(Object sender, TreeNodeEventArgs e)
  {

    // Give the Chapter 2 node a custom image. 
    if(e.Node.Text == "Chapter 2")
    {
      e.Node.ImageUrl="Custom.jpg";
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView TreeNodeDataBound Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView TreeNodeDataBound Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        LeafNodeStyle-ImageUrl="Leaf.jpg"
        ParentNodeStyle-ImageUrl="Parent.jpg"
        RootNodeStyle-ImageUrl="Root.jpg"   
        OnTreeNodeDataBound="Data_Bound"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>


Bei dem folgenden Code handelt es sich um XML-Beispieldaten für das vorherige Beispiel.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
</Book>

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen: