MenuItemBinding.Text Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia tekst wyświetlany dla elementu menu, do którego MenuItemBinding jest stosowany obiekt.
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 StringWartość właściwości
Tekst wyświetlany dla elementu menu, do którego MenuItemBinding jest stosowany. Wartość domyślna to pusty ciąg (""), który wskazuje, że ta właściwość nie jest ustawiona.
Przykłady
Poniższy przykład kodu pokazuje, jak za pomocą Text właściwości określić tekst do wyświetlenia w elemencie menu. Ten tekst jest wyświetlany w każdym elemencie menu, do którego MenuItemBinding jest stosowany obiekt. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML poniżej do pliku o nazwie 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>
Poniższy kod to przykładowe dane mapy witryny dla poprzedniego przykładu.
<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>
Uwagi
Gdy kontrolka Menu jest powiązana ze źródłem danych, użyj Text właściwości , aby określić tekst, który ma być powiązany MenuItem.Text z właściwością MenuItem obiektu. Ten tekst jest wyświetlany w elemencie menu i jest udostępniany wszystkim elementom menu, do których MenuItemBinding zastosowano obiekt.
Uwaga
Tekst pojedynczego elementu menu można zastąpić, ustawiając jego Text właściwość bezpośrednio.
Zamiast używać tej właściwości do wyświetlania tego samego tekstu w każdym elemencie menu, można również powiązać Text właściwość MenuItem obiektu z polem źródła danych, ustawiając TextField właściwość. Po Text renderowaniu właściwość każdego elementu menu, do którego MenuItemBinding zastosowano obiekt, zawiera odpowiednią wartość z pola.
Nie można utworzyć pustych węzłów w kontrolce Menu , ustawiając Text właściwości lub TextField na pusty ciąg (""). Ustawienie tych właściwości na pusty ciąg ma taki sam efekt, jak ustawienie właściwości. W takim przypadku kontrolka Menu tworzy domyślne powiązanie przy użyciu DataSource właściwości . Aby uzyskać więcej informacji, zobacz ASP.NET Mapa zawartości dostępu do danych.
Wartość tej właściwości, po ustawieniu, można zapisać automatycznie w pliku zasobów przy użyciu narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute Temat Globalizacja i Lokalizacja.
