TreeNode.ImageUrl Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la dirección URL de una imagen que se muestra al lado del nodo.
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
Valor de propiedad
La dirección URL de una imagen personalizada que se muestra al lado del nodo. El valor predeterminado es una cadena vacía (""), lo que indica que esta propiedad no está establecida.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ImageUrl propiedad para proporcionar una imagen personalizada para un nodo. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado Book.xml.
<%@ 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>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Data_Bound(ByVal sender As Object, ByVal e As TreeNodeEventArgs)
' Give the Chapter 2 node a custom image.
If e.Node.Text = "Chapter 2" Then
e.Node.ImageUrl = "Custom.jpg"
End If
End Sub
</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>
El código siguiente es datos XML de ejemplo para el ejemplo anterior.
<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>
Comentarios
Utilice la ImageUrl propiedad para especificar una imagen personalizada para el nodo actual en el TreeView control . Esta imagen se muestra junto al nodo y puede estar en cualquier formato de archivo (.jpg, .gif, .bmp, etc.), siempre y cuando el explorador del cliente admita ese formato.
El valor de esta propiedad se almacena en estado de vista.