Esporta (0) Stampa
Espandi tutto

Proprietà MenuItemBinding.FormatString

Aggiornamento: novembre 2007

Ottiene o imposta la stringa che specifica il formato di visualizzazione del testo di una voce di menu a cui viene applicato l'oggetto MenuItemBinding.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in 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)

Valore proprietà

Tipo: System.String

Stringa di formattazione che specifica il formato di visualizzazione del testo di una voce di menu a cui viene applicato l'oggetto MenuItemBinding. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

La proprietà FormatString viene utilizzata per fornire un formato personalizzato a un testo di una voce di menu. La stringa di formato può essere costituita da una stringa letterale, da un segnaposto o da entrambi. La stringa letterale viene visualizzata sotto forma di testo, mentre il segnaposto viene sostituito con il valore associato al testo della voce di menu.

Il segnaposto viene suddiviso in due parti, separate da due punti, nel formato {A:Bxx}. Ad esempio, {0:F2} visualizza un numero a virgola fissa con due posizioni decimali.

Nota:

La stringa segnaposto deve essere racchiusa tra parentesi graffe per indicare che si tratta di un segnaposto e non di una stringa letterale. Il testo non incluso nelle parentesi graffe viene visualizzato come testo in formato letterale.

Rispettando la sintassi standard della stringa di formattazione, il valore che precede i due punti (A nell'esempio generico) specifica l'indice del parametro in un elenco di parametri in base zero. Poiché è possibile visualizzare un solo valore in ciascuna voce di menu, l'indice del parametro può essere impostato solo su 0.

Il carattere che segue i due punti (B nell'esempio generico) specifica il formato di visualizzazione del valore. Nella tabella riportata di seguito vengono elencati i formati comuni.

Carattere di formato

Descrizione

C

I valori numerici sono visualizzati in formato valuta.

D

I valori numerici sono visualizzati in formato decimale.

E

I valori numerici sono visualizzati in formato scientifico (esponenziale).

F

I valori numerici sono visualizzati in formato fisso.

G

I valori numerici sono visualizzati in formato generale.

N

I valori numerici sono visualizzati in formato numerico.

X

I valori numerici sono visualizzati in formato esadecimale.

Nota:

I caratteri di formattazione non fanno distinzione tra maiuscole e minuscole, tranne che per il simbolo X, il quale consente la visualizzazione dei caratteri esadecimali rispettando la distinzione tra maiuscole e minuscole.

Il valore che segue il carattere di formattazione (xx nell'esempio generico) specifica il numero di cifre significative o le posizioni decimali da visualizzare.

Per ulteriori informazioni sulle stringhe di formattazione, vedere Cenni preliminari sulla formattazione.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse utilizzando uno strumento di progettazione. Per ulteriori informazioni, vedere LocalizableAttribute e Globalizzazione e localizzazione ASP.NET.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà FormatString per formattare il testo visualizzato nelle voci di menu di un controllo Menu. Perché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio che seguono in un file denominato 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>



Nel codice riportato di seguito sono riportati i dati della mappa del sito di esempio per l'esempio precedente.

<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 e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft