ListControl.DataTextFormatString Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la chaîne de mise en forme permettant de contrôler l'affichage des données liées au contrôle de liste.
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 StringValeur de propriété
Chaîne de mise en forme des données liées au contrôle. La valeur par défaut est Empty.
- Attributs
Remarques
Utilisez la DataTextFormatString propriété pour fournir un format d’affichage personnalisé des éléments dans un contrôle de liste.
La chaîne de format de données se compose de deux parties, séparées par un signe deux-points, au format { A : Bxx }. Par exemple, la chaîne {0:F2} de mise en forme met en forme la cellule pour afficher un nombre à points fixes avec deux décimales.
Notes
La chaîne entière doit être placée dans des accolades pour indiquer qu’il s’agit d’une chaîne de format et non d’une chaîne littérale. Tout texte en dehors des accolades s’affiche sous forme de texte littéral.
La valeur avant les deux-points (A dans l’exemple général) spécifie l’index de paramètre dans une liste de paramètres de base zéro.
Notes
Cette valeur ne peut être définie que sur 0, car il n’y a qu’une seule valeur dans chaque cellule.
Le caractère après les deux-points (B dans l’exemple général) spécifie le format dans lequel afficher la valeur. Le tableau suivant répertorie les formats courants.
| Caractère de mise en forme | Description |
|---|---|
C |
Affiche les valeurs numériques au format monétaire. |
D |
Affiche les valeurs numériques au format décimal. |
E |
Affiche les valeurs numériques au format scientifique (exponentiel). |
F |
Affiche les valeurs numériques au format fixe. |
G |
Affiche les valeurs numériques au format général. |
N |
Affiche les valeurs numériques au format numérique. |
X |
Affiche les valeurs numériques au format hexadécimal. |
Notes
Le caractère de format ne respecte pas la casse, à l’exception de X, qui affiche les caractères hexadécimaux dans le cas spécifié.
La valeur après le caractère de format (xx dans l’exemple général) spécifie le nombre de chiffres significatifs ou de décimales à afficher.
Le tableau suivant contient des exemples de chaînes de mise en forme et des résultats. Il suppose des paramètres d’anglais standard.
| Valeur numérique | Chaîne de format | Résultats |
|---|---|---|
| 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 | « Total : {0:C}» | Total : 12345,68 $ |
Pour plus d’informations sur la mise en forme des chaînes, consultez Mise en forme des types.
La valeur de cette propriété est stockée dans l’état d’affichage.
Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et skins.
