Lire en anglais

Partager via


UInt32.ToString Méthode

Définition

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente.

Surcharges

ToString()

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente.

ToString(IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture spécifiées.

ToString(String)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié.

ToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture et au format spécifiés.

ToString()

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente.

C#
public override string ToString ();

Retours

Représentation sous forme de chaîne de la valeur de cette instance, composée d’une séquence de chiffres allant de 0 à 9, sans signe ni zéros non significatifs.

Exemples

L’exemple suivant affiche une valeur UInt32 à l’aide de la méthode ToString() par défaut. Il affiche également les représentations sous forme de chaîne de la valeur UInt32 qui résulte de l’utilisation de spécificateurs de format standard. Les exemples sont affichés à l’aide des conventions de mise en forme de la culture en-US.

C#
using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA

Remarques

La méthode ToString() met en forme une valeur UInt32 au format par défaut (« G » ou général) à l’aide de l’objet NumberFormatInfo de la culture actuelle. Si vous souhaitez spécifier un format ou une culture différent, utilisez les autres surcharges de la méthode ToString, comme suit :

Pour utiliser le format Pour la culture Utiliser la surcharge
Format par défaut (« G ») Une culture spécifique ToString(IFormatProvider)
Un format spécifique Culture par défaut (actuelle) ToString(String)
Un format spécifique Une culture spécifique ToString(String, IFormatProvider)

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(IFormatProvider)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture spécifiées.

C#
public string ToString (IFormatProvider provider);
C#
public string ToString (IFormatProvider? provider);

Paramètres

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

Représentation sous forme de chaîne de la valeur de cette instance, qui se compose d’une séquence de chiffres compris entre 0 et 9, sans signe ni zéros non significatifs.

Implémente

Exemples

L’exemple suivant met en forme une valeur entière signée 16 bits à l’aide de plusieurs fournisseurs de format, dont un pour la culture invariante. La sortie de l’exemple illustre que la chaîne mise en forme retournée par la méthode ToString(IFormatProvider) est la même, quel que soit le fournisseur de format.

C#
using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      uint value = 1870924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//             en-US          fr-FR      Invariant
//           1870924        1870924        1870924

Remarques

La méthode ToString(IFormatProvider) met en forme une valeur UInt32 au format par défaut (« G » ou général) à l’aide de l’objet NumberFormatInfo d’une culture spécifiée. Si vous souhaitez spécifier un format différent ou la culture actuelle, utilisez les autres surcharges de la méthode ToString, comme suit :

Pour utiliser le format Pour la culture Utiliser la surcharge
Format par défaut (« G ») Culture par défaut (actuelle) ToString()
Un format spécifique Culture par défaut (actuelle) ToString(String)
Un format spécifique Une culture spécifique ToString(String, IFormatProvider)

Le paramètre provider est une implémentation IFormatProvider. Sa méthode GetFormat retourne un objet NumberFormatInfo qui fournit des informations de mise en forme spécifiques à la culture. Toutefois, aucune des propriétés de la NumberFormatInfo n’est utilisée lors de la mise en forme avec le spécificateur de format numérique général (« G »).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié.

C#
public string ToString (string format);
C#
public string ToString (string? format);

Paramètres

format
String

Chaîne de format numérique.

Retours

Représentation sous forme de chaîne de la valeur de cette instance spécifiée par format.

Exceptions

Le paramètre format n’est pas valide.

Exemples

L’exemple suivant affiche une valeur entière non signée 32 bits à l’aide de chaque chaîne de format standard et de certaines chaînes de format personnalisées.

C#
using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608

Remarques

La méthode ToString(String) met en forme une valeur UInt32 dans un format spécifié à l’aide d’un objet NumberFormatInfo qui représente les conventions de la culture actuelle. Si vous souhaitez utiliser le format par défaut (« G » ou général) ou spécifier une culture différente, utilisez les autres surcharges de la méthode ToString, comme suit :

Pour utiliser le format Pour la culture Utiliser la surcharge
Format par défaut (« G ») Culture par défaut (actuelle) ToString()
Format par défaut (« G ») Une culture spécifique ToString(IFormatProvider)
Un format spécifique Une culture spécifique ToString(String, IFormatProvider)

Le paramètre format peut être n’importe quel chaînes de format numérique standard, ou toute combinaison de chaînes de format numérique personnalisées . Si format est égal à String.Empty ou est null, la valeur de retour de l’objet UInt32 actuel est mise en forme avec le spécificateur de format général (« G »). Si format est une autre valeur, la méthode lève une FormatException.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Le format de la chaîne retournée est déterminé par l’objet NumberFormatInfo pour la culture actuelle. Selon le paramètre format, cet objet contrôle les symboles tels que le séparateur de groupe et le symbole décimal dans la chaîne de sortie. Pour fournir des informations de mise en forme pour les cultures autres que la culture actuelle, appelez la surcharge ToString(String, IFormatProvider).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture et au format spécifiés.

C#
public string ToString (string format, IFormatProvider provider);
C#
public string ToString (string? format, IFormatProvider? provider);

Paramètres

format
String

Chaîne de format numérique.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur cette instance.

Retours

Représentation sous forme de chaîne de la valeur de cette instance spécifiée par format et provider.

Implémente

Exceptions

Le paramètre format n’est pas valide.

Exemples

L’exemple suivant affiche une valeur entière non signée 32 bits à l’aide des spécificateurs de format numérique standard et d’un certain nombre d’objets CultureInfo spécifiques.

C#
using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      uint value = 2222402;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942

Remarques

La méthode ToString(String, IFormatProvider) met en forme une valeur UInt32 dans un format spécifié à l’aide de l’objet NumberFormatInfo d’une culture spécifiée. Si vous souhaitez utiliser des paramètres de mise en forme ou de culture par défaut, utilisez les autres surcharges de la méthode ToString, comme suit :

Pour utiliser le format Pour la culture Utiliser la surcharge
Format par défaut (« G ») Culture par défaut (actuelle) ToString()
Format par défaut (« G ») Une culture spécifique ToString(IFormatProvider)
Un format spécifique Culture par défaut (actuelle) ToString(String)

Le paramètre format peut être n’importe quel chaînes de format numérique standard, ou toute combinaison de chaînes de format numérique personnalisées . Si format est égal à String.Empty ou est null, la valeur de retour de l’objet UInt32 actuel est mise en forme avec le spécificateur de format général (« G »). Si format est une autre valeur, la méthode lève une FormatException.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Le paramètre provider est une implémentation IFormatProvider. Sa méthode GetFormat retourne un objet NumberFormatInfo qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode. Lorsque la méthode ToString(String, IFormatProvider) est appelée, elle appelle la méthode IFormatProvider.GetFormat du paramètre provider et la transmet à un objet Type qui représente le type NumberFormatInfo. La méthode GetFormat retourne ensuite l’objet NumberFormatInfo qui fournit des informations pour mettre en forme la valeur UInt32 actuelle, telle que le symbole de séparateur de groupe ou le symbole décimal. Il existe trois façons d’utiliser le paramètre provider pour fournir des informations de mise en forme à la méthode ToString(String, IFormatProvider) :

  • Vous pouvez transmettre un objet CultureInfo qui représente la culture qui fournit des informations de mise en forme. Sa méthode GetFormat retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme numériques pour cette culture.

  • Vous pouvez transmettre l’objet NumberFormatInfo réel qui fournit des informations de mise en forme numérique. (Son implémentation de GetFormat retourne simplement elle-même.)

  • Vous pouvez passer un objet personnalisé qui implémente IFormatProvider. Sa méthode GetFormat instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.

Si provider est null, la mise en forme de la chaîne retournée est basée sur l’objet NumberFormatInfo de la culture actuelle.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0