MenuItemBinding.ImageUrl-Eigenschaft
Aktualisiert: November 2007
Ruft den URL für ein Bild ab, das neben dem Text eines Menüelements angezeigt wird, für das das MenuItemBinding-Objekt übernommen wird, oder legt diesen fest.
Assembly: System.Web (in System.Web.dll)
/** @property */ public String get_ImageUrl() /** @property */ public void set_ImageUrl(String value)
public function get ImageUrl () : String public function set ImageUrl (value : String)
Eigenschaftenwert
Typ: System.StringDer URL für ein Bild, das neben dem Text eines Menüelements angezeigt wird, für das das MenuItemBinding übernommen wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.
Wenn das Menu-Steuerelement an eine Datenquelle gebunden wird, geben Sie mithilfe der ImageUrl-Eigenschaft den URL eines benutzerdefinierten Bilds an, das an die MenuItem.ImageUrl-Eigenschaft eines MenuItem-Objekts gebunden werden soll. Dieses Bild wird für alle MenuItem-Objekte freigegeben, für die das MenuItemBinding-Objekt übernommen wird. Das Bild wird neben dem Text eines Menüelements angezeigt und kann in einem beliebigen Dateiformat (JPG, GIF, BMP usw.) vorliegen, sofern dieses Format vom Browser des Clients unterstützt wird.
 Hinweis: |
|---|
Sie können das Bild für ein einzelnes Menüelement überschreiben, indem Sie die entsprechende ImageUrl-Eigenschaft direkt festlegen. |
Anstatt mithilfe dieser Eigenschaft dasselbe Bild in jedem Menüelement anzuzeigen, können Sie auch die ImageUrlField-Eigenschaft verwenden, um die ImageUrl-Eigenschaft eines MenuItem-Objekts an ein Feld einer Datenquelle zu binden. Bei der Wiedergabe enthält die ImageUrl-Eigenschaft jedes Menüelements, für das das MenuItemBinding-Objekt übernommen wird, den entsprechenden Wert des Felds.
| Hinweis: |
|---|
Wenn sowohl die ImageUrl-Eigenschaft als auch die ImageUrlField-Eigenschaft festgelegt ist, hat die ImageUrlField-Eigenschaft Vorrang. |
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der ImageUrl-Eigenschaft der URL für ein Bild angegeben wird, das neben dem Text des Menüelements angezeigt werden soll. Dieses Bild wird in jedem Menüelement angezeigt, für das das MenuItemBinding-Objekt übernommen wird. Damit dieses Beispiel wie vorgesehen funktioniert, müssen Sie die nachfolgenden XML-Beispieldaten in die Datei Menu.xml kopieren.
<%@ 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>MenuItemBinding Example</title> </head> <body> <form id="form1" runat="server"> <h3>MenuItemBinding Example</h3> <asp:menu id="NavigationMenu" datasourceid="MenuSource" runat="server"> <databindings> <asp:menuitembinding datamember="MapHomeNode" textfield="Title" valuefield="Description" imageurlfield="ImageUrl" tooltipfield="ToolTip"/> <asp:menuitembinding datamember="MapNode" depth="1" textfield="Title" valuefield="Description" imageurlfield="ImageUrl" tooltipfield="ToolTip"/> <asp:menuitembinding datamember="MapNode" depth="2" text="Static Title" value="Static Description" imageurl="~\Images\StaticImage.jpg" tooltip="Static ToolTip"/> </databindings> </asp:menu> <asp:xmldatasource id="MenuSource" datafile="Menu.xml" runat="server"/> </form> </body> </html>
Im folgenden Code finden Sie ein Beispiel für die Siteübersichtsdaten für das vorherige Beispiel.
<MapHomeNode ImageUrl="~\Images\Home.gif"
Title="Home"
Description="Root Page"
ToolTip="Home Page">
<MapNode ImageUrl="~\Images\Music.gif"
Title="Music"
Description="Music Category"
ToolTip="Music Page">
<MapNode ImageUrl="~\Images\Classical.gif"
Title="Classical"
Description="Classical Section"
ToolTip="Classical Page"/>
<MapNode ImageUrl="~\Images\Rock.gif"
Title="Rock"
Description="Rock Section"
ToolTip="Rock Page"/>
<MapNode ImageUrl="~\Images\Jazz.gif"
Title="Jazz"
Description="Jazz Section"
ToolTip="Jazz Page"/>
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
Title="Movies"
Description="Movies Category"
ToolTip="Movies Page">
<MapNode ImageUrl="~\Images\Action.gif"
Title="Action"
Description="Action Section"
ToolTip="Action Page"/>
<MapNode ImageUrl="~\Images\Drama.gif"
Title="Drama"
Description="Drama Section"
ToolTip="Drama Page"/>
<MapNode ImageUrl="~\Images\Musical.gif"
Title="Musical"
Description="Musical Section"
ToolTip="Musical Page"/>
</MapNode>
</MapHomeNode>
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
