BoundField.DataFormatString Proprietà

  • Riferimento

Definizione

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

Ottiene o imposta la stringa in cui è specificato 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 (""), a indicare che al valore di campo non è stata applicata alcuna formattazione speciale.

Esempio

Un progetto di sito Web Visual Studio con codice sorgente è disponibile per accompagnare questo argomento: Download.

Nell'esempio seguente viene illustrato come usare la DataFormatString proprietà per specificare un formato di visualizzazione personalizzato per i valori di un campo.

Nell'esempio seguente viene illustrata una riga dell'output prodotto da questo esempio.

ProductID Nome ProductNumber ListPrice Peso ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

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 alcuna formattazione speciale.

Nota

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 contenente l'oggetto BoundField è in modalità di sola lettura. Per applicare la stringa di formattazione ai valori dei campi durante la 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 di formattazione , il valore del campo viene sostituito per il {0} segnaposto quando la stringa Item Value: {0}viene visualizzata nell'oggettoBoundField. 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 è inclusa nel testo di visualizzazione finale (il valore del campo dall'origine dati non è incluso). Se il segnaposto è un valore 0 (zero) racchiuso tra parentesi graffe, come illustrato nell'esempio precedente, il valore del campo viene convertito in una stringa per il metodo predefinito. È possibile aggiungere a 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 un formato di valuta.

La formattazione viene applicata usando il Format metodo . Il numero che segue la parentesi graffe sinistra fa parte della sintassi usata da tale metodo e indica quale serie di valori deve usare il segnaposto. Poiché in ogni cella è presente un solo valore di campo, il numero che segue la parentesi graffe 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 sono distinzione tra maiuscole e minuscole, ad eccezione Xdi , 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 le cifre decimali da visualizzare.

Nota

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

Formato carattere Descrizione Esempio
C o 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 o 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 interi. Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234
E o 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 o 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 o g Visualizza i valori numerici in formato generale (la più compatta di notazione fissa o scientifica). È possibile specificare il numero di cifre significative. Formato: {0:G}

-123.456 -> -123.456

Formato: {0:G2}

-123.456 -> -120
N o n Visualizza i valori numerici in formato numero (inclusi separatori di gruppo e 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 o 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 o r Visualizza Single, Doubleo BigInteger valori in formato round trip. Formato: {0:R}

123456789.12345678 -> 123456789.12345678
X o x Visualizza 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 cultura, vedere Stringhe di formato numerico standard. È anche possibile creare stringhe di formato numerico personalizzate. Per altre informazioni, vedere Stringhe di formato numerico personalizzato.

La tabella seguente elenca 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 per un DateTime valore di 6/15/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}

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

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

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

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

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

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

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

15/06/2009 13.45.30 -> 2009-06-15T13.45.30.0900000
R o r Modello RFC1123 (per informazioni, vedere DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}

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

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

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

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

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
U Schema di data/ora completa universale. Formato: {0:U}

6/15/2009 1:45:30 -> lunedì 15 giugno 2009 8:45:30 PM
Y o y Schema di mese e anno. Formato: {0:Y}

6/15/2009 1:45:30 -> giugno 2009

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

Si applica a

Vedi anche