TreeNodeBinding.NavigateUrl 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 a la que se debe vincular al hacer clic en un nodo al que se aplica el objeto TreeNodeBinding.
public:
property System::String ^ NavigateUrl { System::String ^ get(); void set(System::String ^ value); };public string NavigateUrl { get; set; }member this.NavigateUrl : string with get, setPublic Property NavigateUrl As StringValor de propiedad
Dirección URL a la que se debe vincular al hacer clic en un nodo al que se aplica el objeto TreeNodeBinding. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido la propiedad NavigateUrl.
Ejemplos
Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la NavigateUrl propiedad para especificar la dirección URL a la que vincular cuando se hace clic en un nodo al que se aplica el TreeNodeBinding objeto. En el segundo ejemplo de código se proporcionan datos XML de ejemplo para el primer ejemplo de código.
En el ejemplo de código siguiente se muestra cómo usar la NavigateUrl propiedad para especificar la dirección URL a la que se vinculará cuando se haga clic en un nodo al que se aplica el TreeNodeBinding objeto. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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>
En el ejemplo de código siguiente se proporcionan datos XML de ejemplo para el ejemplo anterior.
<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>
Comentarios
Cuando el TreeView control está enlazado a un origen de datos, utilice la NavigateUrl propiedad para especificar la dirección URL que se va a enlazar a la NavigateUrl propiedad de un TreeNode objeto . Esta relación de enlace afecta a todos los objetos a los TreeNode que se aplica el TreeNodeBinding objeto. Cuando se establece esta propiedad, el TreeView control muestra un hipervínculo para el texto del nodo, en lugar de texto sin formato. También puede establecer opcionalmente la Target propiedad para especificar la ventana o marco en el que se va a mostrar el contenido vinculado.
Nota
Puede invalidar selectivamente la NavigateUrl propiedad estableciendo la NavigateUrl propiedad de cada nodo directamente.
En lugar de usar la NavigateUrl propiedad para enlazar la misma dirección URL a cada nodo, puede enlazar la NavigateUrl propiedad de un TreeNode objeto a un campo de un origen de datos estableciendo la NavigateUrlField propiedad .
El valor de esta propiedad se almacena en estado de vista.