MenuItemBinding.ImageUrl Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví adresu URL na obrázek, který se zobrazí vedle textu položky nabídky, na kterou MenuItemBinding je objekt použit.
public:
property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string ImageUrl { get; set; }
member this.ImageUrl : string with get, set
Public Property ImageUrl As String
Hodnota vlastnosti
Adresa URL obrázku, který se zobrazí vedle textu položky nabídky, na kterou MenuItemBinding se použije. Výchozí hodnota je prázdný řetězec (""), který označuje, že tato vlastnost není nastavena.
Příklady
Následující příklad kódu ukazuje použití ImageUrl vlastnosti k určení adresy URL obrázku k zobrazení vedle textu položek nabídky. Tento obrázek se zobrazí v každé položce nabídky, na kterou MenuItemBinding se objekt použije. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML níže do souboru s názvem Menu.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>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>
<%@ 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>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>
Následující kód představuje ukázková data mapy webu pro předchozí příklad.
<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>
Poznámky
Menu Pokud je ovládací prvek svázán se zdrojem dat, použijte ImageUrl vlastnost k určení adresy URL vlastního obrázku pro vytvoření vazby na MenuItem.ImageUrl vlastnost objektuMenuItem. Tento obrázek se sdílí se všemi MenuItem objekty, na které MenuItemBinding se objekt použije. Obrázek se zobrazí vedle textu položky nabídky a může být v libovolném formátu souboru (.jpg, .gif, .bmpatd.), pokud prohlížeč klienta tento formát podporuje.
Poznámka:
Obrázek pro jednotlivé položky nabídky můžete přepsat nastavením jeho ImageUrl vlastnosti přímo.
Místo použití této vlastnosti k zobrazení stejného obrázku v každé položce nabídky můžete také použít ImageUrlField vlastnost k vytvoření vazby ImageUrlMenuItem vlastnosti objektu na pole zdroje dat. Při vykreslení obsahuje vlastnost každé položky nabídky, ImageUrl na kterou MenuItemBinding je objekt použit, odpovídající hodnotu z pole.
Poznámka:
Pokud jsou obě ImageUrlImageUrlField vlastnosti nastaveny, ImageUrlField má tato vlastnost přednost.