ListControl.DataTextFormatString ListControl.DataTextFormatString ListControl.DataTextFormatString ListControl.DataTextFormatString Property

Definizione

Ottiene o imposta la stringa di formattazione utilizzata per controllare il modo in cui vengono visualizzati i dati associati al controllo elenco.Gets or sets the formatting string used to control how data bound to the list control is displayed.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Valore della proprietà

Stringa di formattazione per i dati associati al controllo.The formatting string for data bound to the control. Il valore predefinito è Empty.The default value is Empty.

Commenti

Utilizzare la DataTextFormatString proprietà per specificare un formato di visualizzazione personalizzato per gli elementi in un controllo elenco.Use the DataTextFormatString property to provide a custom display format the items in a list control.

La stringa di formato dati è costituita da due parti, separate da due punti, nel A formato Bxx {:}.The data format string consists of two parts, separated by a colon, in the form { A : Bxx }. Ad esempio, la stringa {0:F2} di formattazione formatta la cella per visualizzare un numero a virgola fissa con due posizioni decimali.For example, the formatting string {0:F2} would format the cell to display a fixed point number with two decimal places.

Nota

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.The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Qualsiasi testo all'esterno delle parentesi graffe viene visualizzato come testo letterale.Any text outside the braces is displayed as literal text.

Il valore prima dei due puntiA (nell'esempio generale) specifica l'indice del parametro in un elenco di parametri in base zero.The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

Nota

Questo valore può essere impostato su 0 solo perché è presente un solo valore in ogni cella.This value can only be set to 0 because there is only one value in each cell.

Il carattere dopo i due puntiB (nell'esempio generale) specifica il formato in cui visualizzare il valore.The character after the colon (B in the general example) specifies the format to display the value in. Nella tabella seguente sono elencati i formati comuni.The following table lists the common formats.

Formato carattereFormat character DescriptionDescription
C Visualizza i valori numerici in formato valuta.Displays numeric values in currency format.
D Visualizza i valori numerici in formato decimale.Displays numeric values in decimal format.
E Visualizza i valori numerici in formato scientifico (esponenziale).Displays numeric values in scientific (exponential) format.
F Visualizza i valori numerici in formato fisso.Displays numeric values in fixed format.
G Visualizza i valori numerici in formato generale.Displays numeric values in general format.
N Visualizza i valori numerici in formato numerico.Displays numeric values in number format.
X Visualizza i valori numerici in formato esadecimale.Displays numeric values in hexadecimal format.

Nota

Per il carattere di formato non viene fatta distinzione tra maiuscole e minuscole, ad eccezione di X, che Visualizza i caratteri esadecimali nel caso specificato.The format character is not case-sensitive, except for X, which displays the hexadecimal characters in the case specified.

Il valore dopo il carattere di formatoxx (nell'esempio generale) specifica il numero di cifre significative o posizioni decimali da visualizzare.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

La tabella seguente contiene esempi di stringhe di formattazione e i risultati.The following table contains examples of formatting strings and the results. Si presuppone che le impostazioni della lingua inglese siano standard.It assumes standard English settings.

Valore numericoNumeric Value Stringa di formatoFormat String RisultatoResult
12345.678912345.6789 "{0:C}""{0:C}" $12,345.68$12,345.68
-12345.6789-12345.6789 "{0:C}""{0:C}" ($12,345.68)($12,345.68)
1234512345 "{0:D}""{0:D}" 1234512345
1234512345 "{0:D8}""{0:D8}" 0001234500012345
12345.678912345.6789 "{0:E}""{0:E}" 1234568E+0041234568E+004
12345.678912345.6789 "{0:E10}""{0:E10}" 1.2345678900 E + 0041.2345678900E+004
12345.678912345.6789 "{0:F}""{0:F}" 12345.6812345.68
12345.678912345.6789 "{0:F0}""{0:F0}" 1234612346
12345.678912345.6789 "{0:G}""{0:G}" 12345.678912345.6789
123456789123456789 "{0:G7}""{0:G7}" 1.234568 E81.234568E8
12345.678912345.6789 "{0:N}""{0:N}" 12,345.6812,345.68
123456789123456789 "{0:N4}""{0:N4}" 123,456,789.0000123,456,789.0000
12345.678912345.6789 "Totale: {0:C}""Total: {0:C}" Totale: $12345,68Total: $12345.68

Per altre informazioni sulla formattazione delle stringhe, vedere Formatting Types (Formattazione dei tipi).For more information on formatting strings, see Formatting Types.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere ThemeableAttribute e ASP.NET temi e interfacce.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche