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.
Dient zum Abrufen oder Festlegen der URL auf ein Bild, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding Objekt angewendet wird.
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 zu einem Bild, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding Objekt angewendet wird. Das
ImageUrl -Eigenschaft ist nicht festgelegt.
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Depth die Eigenschaft verwendet wird, um ein TreeNodeBinding Objekt auf eine bestimmte Knotentiefe anzuwenden. Im zweiten Codebeispiel werden XML-Beispieldaten für das erste Codebeispiel bereitgestellt.
Im folgenden Codebeispiel wird veranschaulicht, wie die ImageUrl Eigenschaft verwendet wird, um ein benutzerdefiniertes Bild für einen Knoten anzugeben, auf den das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.xmlkopieren.
<%@ 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 XML-Beispieldaten 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, .bmpusw.), solange der Clientbrowser dieses Format unterstützt.
Hinweis
Sie können das Bild für einen einzelnen Knoten überschreiben, indem Sie dessen 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 Einstellung der ImageToolTip Eigenschaft in Betracht ziehen. Der von Ihnen angegebene QuickInfo-Text stellt Hilfstechnologiegeräte mit einer Beschreibung des Bilds bereit, mit dem das Steuerelement barrierefreier wird.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.
