Condividi tramite

BoundField.DataFormatString Proprietà

Definizione

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

Ottiene o imposta la stringa che specifica il formato di visualizzazione per il valore del campo.

public:
 virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFormatString { get; set; }
member this.DataFormatString : string with get, set
Public Overridable Property DataFormatString As String

Valore della proprietà

String

Stringa di formattazione che specifica il formato di visualizzazione per il valore del campo. Il valore predefinito è una stringa vuota (""), che indica che non viene applicata alcuna formattazione speciale al valore del campo.

Commenti

Utilizzare la DataFormatString proprietà per specificare un formato di visualizzazione personalizzato per i valori visualizzati nell'oggetto BoundField . Se la DataFormatString proprietà non è impostata, il valore del campo viene visualizzato senza formattazione speciale.

Annotazioni

Nelle versioni di ASP.NET precedenti alla 3.5, è necessario impostare la HtmlEncode proprietà su false per formattare i campi che non sono tipi di dati stringa. In caso contrario, il valore del campo viene convertito in una stringa dal metodo di conversione predefinito prima che venga applicata la stringa di formato archiviata nella DataFormatString proprietà .

Per impostazione predefinita, la stringa di formattazione viene applicata al valore del campo solo quando il controllo associato a dati che contiene l'oggetto BoundField è in modalità di sola lettura. Per applicare la stringa di formattazione ai valori di campo in modalità di modifica, impostare la ApplyFormatInEditMode proprietà su true.

La stringa di formattazione può essere qualsiasi stringa letterale e in genere include un segnaposto per il valore del campo. Ad esempio, nella stringa Item Value: {0}di formattazione il valore del campo viene sostituito dal {0} segnaposto quando la stringa viene visualizzata nell'oggetto BoundField . Il resto della stringa di formattazione viene visualizzato come testo letterale.

Se la stringa di formattazione non include un segnaposto, solo la stringa di formattazione stessa viene inclusa nel testo di visualizzazione finale (il valore del campo dall'origine dati non è incluso). Se il segnaposto è 0 (zero) racchiuso tra parentesi graffe come illustrato nell'esempio precedente, il valore del campo viene convertito in una stringa dal metodo predefinito. È possibile accodare allo zero una stringa che specifica come deve essere formattato il valore del campo. Ad esempio, il segnaposto {0:C} per un campo numerico specifica che il valore del campo deve essere convertito in formato valuta.

La formattazione viene applicata tramite il Format metodo . Il numero che segue la parentesi graffa sinistra fa parte della sintassi utilizzata da tale metodo e indica quale di una serie di valori deve essere utilizzato dal segnaposto. Poiché in ogni cella è presente un solo valore di campo, il numero che segue la parentesi graffa sinistra può essere impostato solo su 0.

Nella tabella seguente sono elencati i caratteri di formato standard per i campi numerici. Questi caratteri di formato non fanno distinzione tra maiuscole e minuscole, ad eccezione di X, che visualizza caratteri esadecimali nel caso specificato. È possibile aggiungere un numero alla maggior parte dei caratteri di formato per specificare il numero di cifre significative o cifre decimali da visualizzare.

Annotazioni

Nella maggior parte dei casi, la formattazione dipende dall'impostazione delle impostazioni cultura del server. Gli esempi sono relativi a un'impostazione delle impostazioni cultura di en-US.

Formato carattere Descrizione Esempio
C oppure c Visualizza i valori numerici in formato valuta. È possibile specificare il numero di posizioni decimali. Formato: {0:C}

123,456 -> \$123,46

Formato: {0:C3}

123,456 -> \$123,456
D oppure d Visualizza i valori integer in formato decimale. È possibile specificare il numero di cifre. Sebbene il tipo sia definito "decimal", i numeri vengono formattati come numeri interi. Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234
E oppure e Visualizza i valori numerici in formato scientifico (esponenziale). È possibile specificare il numero di posizioni decimali. Formato: {0:E}

1052.0329112756 -> 1.052033E+003

Formato: {0:E2}

-1052.0329112756 -> -1.05e+003
F oppure f Visualizza i valori numerici in formato fisso. È possibile specificare il numero di posizioni decimali. Formato: {0:F}

1234.567 -> 1234.57

Formato: {0:F3}

1234.567 -> 1234.567
G oppure g Visualizza i valori numerici in formato generale (la più compatta della notazione scientifica o a virgola fissa). È possibile specificare il numero di cifre significative. Formato: {0:G}

-123.456 -> -123.456

Formato: {0:G2}

-123.456 -> -120
N oppure n Visualizza i valori numerici in formato numerico (inclusi i separatori di gruppo e il segno negativo facoltativo). È possibile specificare il numero di posizioni decimali. Formato: {0:N}

1234.567 -> 1.234.57

Formato: {0:N4}

1234.567 -> 1.234.5670
P oppure p Visualizza i valori numerici in formato percentuale. È possibile specificare il numero di posizioni decimali. Formato: {0:P}

1 -> 100,00%

Formato: {0:P1}

.5 -> 50.0%
R oppure r Visualizza Singlei valori , Doubleo BigInteger in formato round trip. Formato: {0:R}

123456789.12345678 -> 123456789.12345678
X oppure x Visualizza i valori interi in formato esadecimale. È possibile specificare il numero di cifre. Formato: {0:X}

255 -> FF

Formato: {0:x4}

255 -> 00ff

Per altre informazioni e per esempi che mostrano la formattazione per altri valori delle impostazioni cultura, vedere Stringhe di formato numerico standard. È anche possibile creare stringhe di formato numerico personalizzate. Per altre informazioni, vedere Stringhe di formato numerico personalizzato.

Nella tabella seguente sono elencati i caratteri di formato per DateTime i campi. La maggior parte di queste specifiche di formattazione comporta un output diverso a seconda delle impostazioni cultura. Gli esempi sono relativi al DateTime valore 15/6/2009 1:45:30 pm con un'impostazione delle impostazioni cultura di en-US.

Formato carattere Descrizione Esempio
d Schema di data breve. Formato: {0:d}

15/06/2009 1:45:30 -> 15/6/2009
D Schema di data estesa. Formato: {0:D}

15/06/2009 1:45:30 ->Lunedì, 15 giugno 2009
f Schema di data/ora completa (ora breve). Formato: {0:f}

15/06/2009 1:45:30 -> Lunedì, 15 giugno 2009 1:45 PM
F Schema di data/ora completa (ora estesa). Formato: {0:F}

15/06/2009 1:45:30 -> Lunedì, 15 giugno 2009 1:45:30 PM
g Schema di data/ora generale (ora breve). Formato: {0:g}

15/06/2009 1:45:30 -> 15/06/2009 1:45 PM
G Schema di data/ora generale (ora estesa). Formato: {0:G}

15/06/2009 1:45:30 -> 15/6/2009 1:45:30 PM
M oppure m Schema di mese/giorno. Formato: {0:M}

15/06/2009 1:45:30 -> 15 giugno
O oppure o Modello di data/ora round trip. Formato: {0:o}

15/6/2009 1:45:30 -> 2009-06-15T13:45:30.09000000
R oppure r RFC1123 pattern (per informazioni, vedere DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}

15/6/2009 1:45:30 PM -> Lun, 15 Giugno 2009 20:45:30 GMT
s Schema di data/ora ordinabile. Formato: {0:s}

15/06/2009 1:45:30 -> 2009-06-15T13:45:30
t Schema di ora breve. Formato: {0:t}

15/06/2009 1:45:30 -> 13:45 PM
T Schema di ora estesa. Formato: {0:T}

15/06/2009 1:45:30 -> 1:45:30
u Schema di data/ora ordinabile universale. Formato: {0:u}

15/06/2009 1:45:30 -> 2009-06-15 20:45:30Z
U Modello di data/ora completo universale. Formato: {0:U}

15/06/2009 1:45:30 -> Lunedì, 15 giugno 2009 8:45:30 PM
Y oppure y Schema di mese e anno. Formato: {0:Y}

15/06/2009 1:45:30 -> Giugno 2009

Per altre informazioni e per esempi che mostrano la formattazione per altri valori delle impostazioni cultura, vedere Stringhe di formato di data e ora standard. È anche possibile creare stringhe di formato di data e ora personalizzate. Per altre informazioni, vedere Stringhe di formato di data e ora personalizzate.

Si applica a

Vedi anche