MenuItemBinding.Text 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.
Ruft den Text ab, der für das Menüelement angezeigt wird, für das das MenuItemBinding-Objekt übernommen wird, oder legt diesen fest.
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 StringEigenschaftswert
Der Text, der für das Menüelement angezeigt wird, für das das MenuItemBinding übernommen wird. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Text -Eigenschaft den Text angeben, der in einem Menüelement angezeigt werden soll. Dieser Text wird in jedem Menüelement angezeigt, auf das das MenuItemBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei mit dem Namen 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>
<%@ 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>
Der folgende Code sind Beispielwebsiteü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>
Hinweise
Wenn das Menu Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die Text -Eigenschaft, um den Text anzugeben, der an die MenuItem.Text Eigenschaft eines MenuItem Objekts gebunden werden soll. Dieser Text wird in einem Menüelement angezeigt und für alle Menüelemente freigegeben, auf die das MenuItemBinding Objekt angewendet wird.
Hinweis
Sie können den Text für ein einzelnes Menüelement überschreiben, indem Sie dessen Text Eigenschaft direkt festlegen.
Anstatt diese Eigenschaft zum Anzeigen desselben Texts in jedem Menüelement zu verwenden, können Sie die Text Eigenschaft eines MenuItem Objekts auch an ein Feld einer Datenquelle binden, indem Sie die TextField -Eigenschaft festlegen. Beim Rendern enthält die Text Eigenschaft jedes Menüelements, auf das das MenuItemBinding Objekt angewendet wird, den entsprechenden Wert aus dem Feld.
Hinweis
Wenn die Text Eigenschaften und TextField festgelegt sind, hat die TextField Eigenschaft Vorrang.
Sie können keine leeren Knoten in einem Menu Steuerelement erstellen, indem Sie die Text Eigenschaften oder TextField auf die leere Zeichenfolge ("") festlegen. Das Festlegen dieser Eigenschaften auf die leere Zeichenfolge hat die gleiche Auswirkung wie das Festlegen der Eigenschaften. In diesem Fall erstellt das Menu -Steuerelement mithilfe der DataSource -Eigenschaft eine Standardbindung. Weitere Informationen finden Sie unter ASP.NET Datenzugriffsinhaltszuordnung.
Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.
