MenuItemBinding.Text 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 wordt de tekst opgehaald of ingesteld die wordt weergegeven voor het menu-item waarop het MenuItemBinding object wordt toegepast.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };public string Text { get; set; }member this.Text : string with get, setPublic Property Text As StringWaarde van eigenschap
De tekst die wordt weergegeven voor het 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 Text eigenschap gebruikt om de tekst op te geven die moet worden weergegeven in een menu-item. Deze tekst 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 Text eigenschap om de tekst op te geven die moet worden gekoppeld aan de MenuItem.Text eigenschap van een MenuItem object. Deze tekst wordt weergegeven in een menu-item en wordt gedeeld met alle menu-items waarop het MenuItemBinding object wordt toegepast.
Note
U kunt de tekst voor een afzonderlijk menu-item overschrijven door de eigenschap rechtstreeks in Text te stellen.
In plaats van deze eigenschap te gebruiken om dezelfde tekst weer te geven in elk menu-item, kunt u de Text eigenschap van een MenuItem object ook binden aan een veld van een gegevensbron door de TextField eigenschap in te stellen. Wanneer deze wordt weergegeven, bevat de Text eigenschap van elk menu-item waarop het MenuItemBinding object wordt toegepast de bijbehorende waarde uit het veld.
Note
Als de Text eigenschappen TextField beide zijn ingesteld, heeft de TextField eigenschap voorrang.
U kunt geen lege knooppunten in een Menu besturingselement maken door de Text of TextField eigenschappen in te stellen op de lege tekenreeks (""). Het instellen van deze eigenschappen op de lege tekenreeks heeft hetzelfde effect als het niet instellen van de eigenschappen. In dat geval maakt het Menu besturingselement een standaardbinding met behulp van de DataSource eigenschap. Zie ASP.NET Data Access Content Map voor meer informatie.
De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.
