TreeNodeBinding.ImageUrl Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die URL für ein Bild ab, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diese URL fest.
public:
property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };public string ImageUrl { get; set; }member this.ImageUrl : string with get, setPublic Property ImageUrl As StringEigenschaftswert
Die URL für ein Bild, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird. Die Die ImageUrl-Eigenschaft ist nicht festgelegt.
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie mithilfe der Depth Eigenschaft ein Objekt auf eine TreeNodeBinding bestimmte Knotentiefe anwenden. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der ImageUrl Eigenschaft ein benutzerdefiniertes Bild für einen Knoten angeben, auf den das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen 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>
Im folgenden Codebeispiel werden Beispiel-XML-Daten für das vorherige Beispiel bereitgestellt.
<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>
Hinweise
Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die ImageUrl Eigenschaft, um ein benutzerdefiniertes Bild anzugeben, das an die ImageUrl Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Das Bild wird neben einem Knoten angezeigt und kann sich in einem beliebigen Dateiformat befinden (.jpg, .gif, .bmp usw.), solange der Clientbrowser dieses Format unterstützt.
Hinweis
Sie können das Bild für einen einzelnen Knoten überschreiben, indem Sie seine ImageUrl Eigenschaft direkt festlegen.
Anstatt diese Eigenschaft zum Binden desselben Bilds an jeden Knoten zu verwenden, können Sie die ImageUrl Eigenschaft eines TreeNode Objekts an ein Feld einer Datenquelle binden, indem Sie die ImageUrlField Eigenschaft festlegen.
Beim Anzeigen eines Bilds neben einem Knoten mit der ImageUrl Eigenschaft sollten Sie auch die Eigenschaft festlegen ImageToolTip . Der von Ihnen angegebene QuickInfo-Text enthält Hilfstechnologiengeräte mit einer Beschreibung des Bilds, das verwendet werden kann, um das Steuerelement barrierefreier zu gestalten.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.