MenuItemBinding.FormatString Propriedade

Definição

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 string FormatString { get; set; }

Valor da propriedade

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.

Exemplos

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>

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>

Comentários

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.

Aplica-se a

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

Confira também