MenuItemBinding.Text Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define o texto apresentado para o item do menu ao qual o MenuItemBinding objeto é aplicado.
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 StringValor de Propriedade
O texto é mostrado para o item do menu ao qual se aplica.MenuItemBinding O padrão é uma cadeia vazia (""), o que indica que esta propriedade não está definida.
Exemplos
O exemplo de código seguinte demonstra como usar a Text propriedade para especificar o texto a ser exibido num item do menu. Este texto é exibido em cada item do menu ao qual o MenuItemBinding objeto é aplicado. Para que este exemplo funcione corretamente, deve copiar os dados XML de exemplo abaixo para um ficheiro chamado 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>
O código seguinte é um exemplo de dados de mapa de sítios para o exemplo anterior.
<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>
Observações
Quando o controlo Menu está ligado a uma fonte de dados, use a Text propriedade para especificar o texto a vincular à MenuItem.Text propriedade de um MenuItem objeto. Este texto é exibido num item de menu e partilhado com todos os itens de menu a que o MenuItemBinding objeto é aplicado.
Note
Pode sobrescrever o texto de um item individual do menu definindo diretamente a sua Text propriedade.
Em vez de usar esta propriedade para mostrar o mesmo texto em cada item do menu, também pode vincular a Text propriedade de um MenuItem objeto a um campo de uma fonte de dados definindo a TextField propriedade. Quando renderizado, a Text propriedade de cada item do menu ao qual o MenuItemBinding objeto é aplicado contém o valor correspondente do campo.
Note
Se as Text propriedades e TextField forem ambas conjuntas, a TextField propriedade tem precedência.
Não pode criar nós vazios num Menu controlo definindo as Text propriedades ou TextField para a cadeia vazia (""). Definir estas propriedades para a cadeia vazia tem o mesmo efeito que não definir as propriedades. Nesse caso, o controlo Menu cria uma ligação por defeito usando a DataSource propriedade. Para mais informações, consulte ASP.NET Data Access Content Map.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.
