ListControl.DataTextFormatString Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la stringa di formattazione usata per controllare il modo in cui vengono visualizzati i dati associati all'elenco.
public:
virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };public virtual string DataTextFormatString { get; set; }[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }member this.DataTextFormatString : string with get, set[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, setPublic Overridable Property DataTextFormatString As StringValore della proprietà
Stringa di formattazione per i dati associati al controllo. Il valore predefinito è Empty.
- Attributi
Commenti
Utilizzare la DataTextFormatString proprietà per specificare un formato di visualizzazione personalizzato degli elementi in un controllo elenco.
La stringa di formato dati è costituita da due parti, separate da due punti, nel formato { A : Bxx }. Ad esempio, la stringa {0:F2} di formattazione formatterebbe la cella per visualizzare un numero di punto fisso con due posizioni decimali.
Nota
L'intera stringa deve essere racchiusa tra parentesi graffe per indicare che è una stringa di formato e non una stringa letterale. Qualsiasi testo esterno alle parentesi graffe viene visualizzato come testo letterale.
Il valore prima dei due punti (A nell'esempio generale) specifica l'indice dei parametri in un elenco di parametri in base zero.
Nota
Questo valore può essere impostato solo su 0 perché in ogni cella è presente un solo valore.
Il carattere dopo i due punti (B nell'esempio generale) specifica il formato in cui visualizzare il valore. Nella tabella seguente sono elencati i formati comuni.
| Formato carattere | Descrizione |
|---|---|
C |
Visualizza i valori numerici in formato valuta. |
D |
Visualizza i valori numerici in formato decimale. |
E |
Visualizza i valori numerici in formato scientifico (esponenziale). |
F |
Visualizza i valori numerici in formato fisso. |
G |
Visualizza i valori numerici in formato generale. |
N |
Visualizza i valori numerici in formato numero. |
X |
Visualizza valori numerici in formato esadecimale. |
Nota
Il carattere di formato non è distinzione tra maiuscole e minuscole, ad eccezione Xdi , che visualizza i caratteri esadecimali nel caso specificato.
Il valore dopo il carattere di formato (xx nell'esempio generale) specifica il numero di cifre significative o cifre decimali da visualizzare.
La tabella seguente contiene esempi di stringhe di formattazione e dei risultati. Presuppone le impostazioni in inglese standard.
| Valore numerico | Stringa formato | Risultato |
|---|---|---|
| 12345.6789 | "{0:C}" | $12,345.68 |
| -12345.6789 | "{0:C}" | ($12,345.68) |
| 12345 | "{0:D}" | 12345 |
| 12345 | "{0:D8}" | 00012345 |
| 12345.6789 | "{0:E}" | 1234568E+004 |
| 12345.6789 | "{0:E10}" | 1.2345678900E+004 |
| 12345.6789 | "{0:F}" | 12345.68 |
| 12345.6789 | "{0:F0}" | 12346 |
| 12345.6789 | "{0:G}" | 12345.6789 |
| 123456789 | "{0:G7}" | 1.234568E8 |
| 12345.6789 | "{0:N}" | 12,345.68 |
| 123456789 | "{0:N4}" | 123,456,789.0000 |
| 12345.6789 | "Totale: {0:C}" | Totale: $12345.68 |
Per altre informazioni sulla formattazione delle stringhe, vedere Formatting Types (Formattazione dei tipi).
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e skin.
