Esta documentación está archivada y no tiene mantenimiento.

MenuItemBinding.FormatString (Propiedad)

Actualización: noviembre 2007

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.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public string FormatString { get; set; }
/** @property */
public String get_FormatString()
/** @property */
public  void set_FormatString(String value)

public function get FormatString () : String
public function set FormatString (value : String)

Valor de propiedad

Tipo: System.String
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. El valor predeterminado es una cadena vacía (""), lo que indica que esta propiedad no está establecida.

La propiedad FormatString se utiliza para proporcionar un formato personalizado al texto de un elemento de menú. La cadena de formato puede ser una cadena literal, un marcador de posición, o ambas cosas. La cadena literal se muestra tal cuál, mientras que el marcador de posición se reemplaza con el valor enlazado al texto del elemento de menú.

El marcador de posición está dividido en dos partes, separadas por dos puntos, con la forma {A:Bxx}. Por ejemplo, {0:F2} muestra un número de punto fijo con dos posiciones decimales.

8yabz81s.alert_note(es-es,VS.90).gifNota:

La cadena del marcador de posición debe ir entre llaves, para indicar que se trata de un marcador de posición y no de una cadena literal. El texto situado fuera de las llaves se muestra como texto literal.

Siguiendo la sintaxis de cadena de formato estándar, el valor que delante de los dos puntos (A en el ejemplo general) especifica el índice de parámetro en una lista de parámetros basada en cero. Puesto que sólo se puede mostrar un valor en cada elemento de menú, el índice de parámetro sólo se puede establecer en 0.

El carácter que va después de los dos puntos (B en el ejemplo general) especifica el formato de presentación del valor. En la siguiente tabla se recogen los formatos comunes.

Carácter de formato

Descripción

C

Muestra los valores numéricos en formato de moneda.

D

Muestra los valores numéricos en formato decimal.

E

Muestra los valores numéricos en formato científico (exponencial).

F

Muestra los valores numéricos en formato fijo.

G

Muestra los valores numéricos en formato general.

N

Muestra los valores numéricos en formato numérico.

X

Muestra los valores numéricos en formato hexadecimal.

8yabz81s.alert_note(es-es,VS.90).gifNota:

Los caracteres de formato no hacen distinción entre mayúsculas y minúsculas, excepto en el caso de X, que muestra los caracteres hexadecimales en mayúscula o minúscula, según se indique.

El valor que aparece después del carácter de formato (xx en el ejemplo general) especifica el número de dígitos significativos o posiciones decimales utilizados que se van a mostrar.

Para obtener más información sobre las cadenas de formato, vea Información general sobre formatos.

El valor de esta propiedad, cuando está establecida, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttribute y Globalización y adaptación en ASP.NET.

En el ejemplo de código siguiente se indica cómo usar la propiedad FormatString para dar formato al texto que se muestra en los elementos de menú de un control Menu. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo que se proporcionan más abajo en un archivo denominado 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>



El siguiente código constituye los datos de un mapa del sitio de ejemplo para el ejemplo 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>

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: