MenuItemBinding.ImageUrl Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de URL op of stelt u deze in op een afbeelding die wordt weergegeven naast de tekst van een menu-item waarop het MenuItemBinding object wordt toegepast.
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 StringWaarde van eigenschap
De URL naar een afbeelding die wordt weergegeven naast de tekst van een menu-item waarop de MenuItemBinding toepassing is toegepast. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ImageUrl eigenschap gebruikt om de URL naar een afbeelding op te geven die naast de tekst van de menu-items moet worden weergegeven. Deze afbeelding wordt weergegeven in elk menu-item waarop het MenuItemBinding object wordt toegepast. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens hieronder kopiëren naar een bestand met de naam 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>
De volgende code is voorbeeld van siteoverzichtsgegevens voor het vorige voorbeeld.
<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>
Opmerkingen
Wanneer het Menu besturingselement is gebonden aan een gegevensbron, gebruikt u de ImageUrl eigenschap om de URL van een aangepaste afbeelding op te geven die aan de MenuItem.ImageUrl eigenschap van een MenuItem object moet worden gekoppeld. Deze afbeelding wordt gedeeld met alle MenuItem objecten waarop het MenuItemBinding object wordt toegepast. De afbeelding wordt weergegeven naast de tekst van een menu-item en kan elke bestandsindeling hebben (.jpg, .gif, .bmpenzovoort), zolang de browser van de client die indeling ondersteunt.
Note
U kunt de afbeelding voor een afzonderlijk menu-item overschrijven door de ImageUrl eigenschap rechtstreeks in te stellen.
In plaats van deze eigenschap te gebruiken om dezelfde afbeelding weer te geven in elk menu-item, kunt u de ImageUrlField eigenschap ook gebruiken om de ImageUrl eigenschap van een MenuItem object te binden aan een veld van een gegevensbron. Wanneer deze wordt weergegeven, bevat de ImageUrl eigenschap van elk menu-item waarop het MenuItemBinding object wordt toegepast de bijbehorende waarde uit het veld.
Note
Als de ImageUrl eigenschappen ImageUrlField beide zijn ingesteld, heeft de ImageUrlField eigenschap voorrang.
