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 utilisée pour 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 pour les 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é pour les éléments d’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, sous la forme { A : Bxx }. Par exemple, la chaîne {0:F2} de mise en forme met en forme la cellule pour afficher un nombre de points fixes avec deux décimales.
Note
La chaîne entière doit être placée entre 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 le signe 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.
Note
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 le signe 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 des 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 des valeurs numériques au format hexadécimal. |
Note
Le caractère de format n’est pas sensible à la casse, sauf pour 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 part du principe que les paramètres anglais standard.
| Valeur numérique | Chaîne de format | Résultat |
|---|---|---|
| 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 Types de mise en forme.
La valeur de cette propriété est stockée dans l’état d’affichage.
Cette propriété ne peut pas être définie par des thèmes ou des thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et peaux.
