MenuItemBinding.FormatString Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cadeia de caracteres que especifica o formato de exibição do texto de um item de menu ao qual o objeto MenuItemBinding é aplicado.
public:
property System::String ^ FormatString { System::String ^ get(); void set(System::String ^ value); };
public string FormatString { get; set; }
member this.FormatString : string with get, set
Public Property FormatString As String
Uma cadeia de caracteres de formatação que especifica o formato de exibição para o texto de um item de menu ao qual o MenuItemBinding é aplicado. O padrão é uma cadeia de caracteres vazia (""), que indica que essa propriedade não está definida.
O exemplo de código a seguir demonstra como usar a FormatString propriedade para formatar o texto exibido nos itens de menu de um Menu controle. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo para um arquivo 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"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</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"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
O código a seguir é dados de mapa de site de exemplo 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>
A FormatString propriedade é usada para fornecer um formato personalizado para o texto de um item de menu. A cadeia de caracteres de formato pode consistir em uma cadeia de caracteres literal, um espaço reservado ou ambos. A cadeia de caracteres literal é exibida textualmente, enquanto o espaço reservado é substituído pelo valor associado ao texto do item de menu.
O espaço reservado é dividido em duas partes, separadas por dois-pontos, no formato {A
:Bxx
}. Por exemplo, {0:F2} exibe um número de ponto fixo com duas casas decimais.
Observação
A cadeia de caracteres de espaço reservado deve estar entre chaves para indicar que é um espaço reservado e não uma cadeia de caracteres literal. Qualquer texto fora das chaves é exibido como texto literal.
Mantendo a sintaxe de cadeia de caracteres de formatação padrão, o valor antes dos dois-pontos (A
no exemplo geral) especifica o índice de parâmetro em uma lista de parâmetros baseada em zero. Como apenas um valor pode ser exibido em cada item de menu, o índice de parâmetro pode ser definido apenas como 0.
O caractere após os dois-pontos (B
no exemplo geral) especifica o formato de exibição para o valor. A tabela a seguir lista os formatos comuns.
Caractere de formato | Descrição |
---|---|
C |
Exibe valores numéricos no formato de moeda. |
D |
Exibe valores numéricos no formato decimal. |
E |
Exibe valores numéricos no formato científico (exponencial). |
F |
Exibe valores numéricos em formato fixo. |
G |
Exibe valores numéricos no formato geral. |
N |
Exibe valores numéricos no formato de número. |
X |
Exibe valores numéricos no formato hexadecimal. |
Observação
Os caracteres de formato não diferenciam maiúsculas de minúsculas, exceto para X
, que exibe os caracteres hexadecimal no caso especificado.
O valor após o caractere de formato (xx
no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidas.
Para mais informações sobre cadeias de caracteres de formatação, consulte Tipos de formatação.
O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttributeGlobalização e Localização.
Produto | Versões |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: