ListControl.DataTextFormatString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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, set
Public Overridable Property DataTextFormatString As String

Valore della proprietà

String

Stringa di formattazione per i dati associati al controllo. Il valore predefinito è Empty.

Attributi
ThemeableAttribute

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.

Si applica a

Vedi anche