MenuItemBinding.FormatString Propiedad

Definición

Obtiene o establece la cadena que especifica el formato de presentación del texto de un elemento de menú en el que se aplica el objeto MenuItemBinding.Gets or sets the string that specifies the display format for the text of a menu item to which the MenuItemBinding object is applied.

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

Valor de propiedad

Cadena de formato que especifica el formato de presentación del texto de un elemento de menú en el que se aplica el objeto MenuItemBinding.A formatting string that specifies the display format for the text of a menu item to which the MenuItemBinding is applied. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.The default is an empty string (""), which indicates that this property is not set.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad FormatString para dar formato al texto que se muestra en los elementos de menú de un control Menu.The following code example demonstrates how to use the FormatString property to format the text displayed in the menu items of a Menu control. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado menu. Xml.For this example to work correctly, you must copy the sample XML data below to a file named 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>

El código siguiente es un ejemplo de datos del mapa del sitio para el ejemplo anterior.The following code is sample site map data for the previous example.

<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>

Comentarios

La propiedad FormatString se utiliza para proporcionar un formato personalizado para el texto de un elemento de menú.The FormatString property is used to provide a custom format for a menu item's text. La cadena de formato puede constar de una cadena literal, un marcador de posición o ambos.The format string can consist of a literal string, a placeholder, or both. La cadena literal se muestra literalmente, mientras que el marcador de posición se reemplaza por el valor que está enlazado al texto del elemento de menú.The literal string is displayed verbatim, while the placeholder is replaced with the value that is bound to the menu item's text.

El marcador de posición se divide en dos partes, separadas por dos puntos, con el formato {A:Bxx}.The placeholder is split into two parts, separated by a colon, in the form {A:Bxx}. Por ejemplo, {0:F2} muestra un número de punto fijo con dos posiciones decimales.For example, {0:F2} displays a fixed-point number with two decimal places.

Nota

La cadena del marcador de posición debe ir entre llaves para indicar que es un marcador de posición y no una cadena literal.The placeholder string must be enclosed in braces to indicate that it is a placeholder and not a literal string. Cualquier texto que esté fuera de las llaves se muestra como texto literal.Any text outside the braces is displayed as literal text.

Manteniendo la sintaxis de la cadena de formato estándar, el valor que va delante del signo de dos puntos (A en el ejemplo general) especifica el índice del parámetro en una lista de parámetros de base cero.Keeping to the standard formatting string syntax, the value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters. Dado que solo se puede mostrar un valor en cada elemento de menú, el índice del parámetro solo se puede establecer en 0.Because only one value can be displayed in each menu item, the parameter index can be set only to 0.

El carácter que va detrás del signo de dos puntos (B en el ejemplo general) especifica el formato de presentación del valor.The character after the colon (B in the general example) specifies the display format for the value. En la tabla siguiente se enumeran los formatos comunes.The following table lists the common formats.

Carácter de formatoFormat character DescripciónDescription
C Muestra los valores numéricos en formato de moneda.Displays numeric values in currency format.
D Muestra los valores numéricos en formato decimal.Displays numeric values in decimal format.
E Muestra los valores numéricos en formato científico (exponencial).Displays numeric values in scientific (exponential) format.
F Muestra los valores numéricos en formato fijo.Displays numeric values in fixed format.
G Muestra los valores numéricos en formato general.Displays numeric values in general format.
N Muestra los valores numéricos en formato de número.Displays numeric values in number format.
X Muestra los valores numéricos en formato hexadecimal.Displays numeric values in hexadecimal format.

Nota

Los caracteres de formato no distinguen mayúsculas de minúsculas, excepto X, que muestra los caracteres hexadecimales en el caso especificado.The format characters are not case-sensitive, except for X, which displays the hexadecimal characters in the case specified.

El valor después del carácter de formato (xx en el ejemplo general) especifica el número de dígitos significativos o posiciones decimales que se van a mostrar.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

Para obtener más información sobre cómo dar formato a las cadenas, vea Formatting Types (Aplicar formato a tipos).For more information on formatting strings, see Formatting Types.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obtener más información, vea LocalizableAttribute y globalización y localización.For more information, see LocalizableAttribute and Globalization and Localization.

Se aplica a

Consulte también: