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 utilizzata per controllare la modalità di visualizzazione dei dati associati al controllo 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 fornire 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 formatta la cella per visualizzare un numero a virgola fissa con due posizioni decimali.
Annotazioni
L'intera stringa deve essere racchiusa tra parentesi graffe per indicare che si tratta di una stringa di formato e non di una stringa letterale. Qualsiasi testo all'esterno delle 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 in base zero di parametri.
Annotazioni
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 numerico. |
X |
Visualizza i valori numerici in formato esadecimale. |
Annotazioni
Il carattere di formato non fa 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 impostazioni standard per l'inglese.
| Valore numerico | Stringa di formattazione | Result |
|---|---|---|
| 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 Formattazione dei tipi.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
Questa proprietà non può essere impostata in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.
