TreeNodeBinding.NavigateUrl Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia adres URL, do którego ma być link po kliknięciu TreeNodeBinding węzła, do którego jest stosowany obiekt.
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 StringWartość właściwości
Adres URL do połączenia z węzłem, do którego TreeNodeBinding jest stosowany obiekt, jest klikany. Wartość domyślna to pusty ciąg (""), który wskazuje, że właściwość nie jest ustawiona NavigateUrl .
Przykłady
Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak za pomocą NavigateUrl właściwości określić adres URL, do którego ma być link po kliknięciu węzła, do którego TreeNodeBinding jest stosowany obiekt. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.
W poniższym przykładzie kodu pokazano, jak za pomocą NavigateUrl właściwości określić adres URL, do którego ma być link po kliknięciu węzła, do którego TreeNodeBinding jest stosowany obiekt. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML podane po tym przykładzie kodu do pliku o nazwie 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>
Poniższy przykład kodu zawiera przykładowe dane XML dla poprzedniego przykładu.
<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>
Uwagi
Gdy kontrolka TreeView jest powiązana ze źródłem danych, użyj NavigateUrl właściwości , aby określić adres URL, który ma być powiązany NavigateUrl z właściwością TreeNode obiektu. Ta relacja powiązania ma wpływ na wszystkie TreeNode obiekty, do których TreeNodeBinding jest stosowany obiekt. Po ustawieniu tej właściwości kontrolka TreeView wyświetla hiperlink dla tekstu węzła, a nie zwykły tekst. Możesz również opcjonalnie ustawić Target właściwość , aby określić okno lub ramkę, w której ma być wyświetlana połączona zawartość.
Uwaga
Właściwość można selektywnie zastąpić NavigateUrl , ustawiając NavigateUrl właściwość każdego węzła bezpośrednio.
Zamiast używać NavigateUrl właściwości do powiązania tego samego adresu URL z każdym węzłem, można powiązać NavigateUrl właściwość TreeNode obiektu z polem źródła danych, ustawiając NavigateUrlField właściwość .
Wartość tej właściwości jest przechowywana w stanie widoku.