UInt32.ToString UInt32.ToString UInt32.ToString UInt32.ToString Method

Définition

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance to its equivalent string representation.

Surcharges

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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 donnée.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de format spécifiques à la culture.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) 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é.Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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 donnée.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Paramètres

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.An object that supplies culture-specific formatting information.

Retours

Représentation sous forme de chaîne de la valeur de cette instance, constituée d'une séquence de chiffres entre 0 et 9, sans signe ni zéro non significatif.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Implémente

Exemples

L’exemple suivant met en forme une valeur d’entier 16 bits signé en utilisant plusieurs fournisseurs de format, y compris un pour la culture dite indifférente.The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. La sortie de l’exemple montre que la chaîne mise en forme retournée ToString(IFormatProvider) par la méthode est la même quel que soit le fournisseur de format.The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

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
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInteger = 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)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'        en-US          fr-FR      Invariant
'      1870924        1870924        1870924

Remarques

La ToString(IFormatProvider) méthode met en UInt32 forme une valeur dans le format par défaut (« G » ou général) à NumberFormatInfo l’aide de l’objet d’une culture spécifiée.The ToString(IFormatProvider) method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Si vous souhaitez spécifier un autre format ou la culture actuelle, utilisez les autres surcharges de la ToString méthode, comme suit:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)

Le provider paramètre est une IFormatProvider implémentation.The provider parameter is an IFormatProvider implementation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations de mise en forme propres à la culture.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Toutefois, aucune des propriétés de NumberFormatInfo n’est utilisée lors de la mise en forme avec le spécificateur de format numérique général (« G »).However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Voir aussi

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de format spécifiques à la culture.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Paramètres

format
String String String String

Chaîne de format numérique.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture se rapportant à cette instance.An object that supplies culture-specific formatting information about this instance.

Retours

Représentation sous forme de chaîne de la valeur de cette instance, telle que spécifiée par format et provider.The string representation of the value of this instance as specified by format and provider.

Implémente

Exceptions

Le paramètre format n'est pas valide.The format parameter is invalid.

Exemples

L’exemple suivant affiche une valeur d’entier non signé 32 bits à l’aide des spécificateurs de format numériques standard et d’un certain CultureInfo nombre d’objets spécifiques.The following example displays a 32-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

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
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UInteger = 2222402
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' 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 ToString(String, IFormatProvider) méthode met en UInt32 forme une valeur dans un format spécifié à NumberFormatInfo l’aide de l’objet d’une culture spécifiée.The ToString(String, IFormatProvider) method formats a UInt32 value in a specified format by using the NumberFormatInfo object of a specified culture. Si vous souhaitez utiliser des paramètres de format ou de culture par défaut, utilisez les autres surcharges de la ToString méthode, comme suit :If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)

Le format paramètre peut être n’importe quelle chaîne de format numérique standardvalide, ou n’importe quelle combinaison de chaînes de format numériques personnalisées.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Si format est égal à String.Empty ou a nullla valeur, la valeur de retour UInt32 de l’objet actuel est mise en forme avec le spécificateur de format général (« G »).If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). Si format est une autre valeur, la méthode lève une FormatException.If format is any other value, the method throws a FormatException.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Le provider paramètre est une IFormatProvider implémentation.The provider parameter is an IFormatProvider implementation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Quand la ToString(String, IFormatProvider) méthode est appelée, elle appelle la provider méthode du IFormatProvider.GetFormat paramètre et lui passe un Type objet qui représente le NumberFormatInfo type.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. La GetFormat méthode retourne ensuite l' NumberFormatInfo objet qui fournit des informations pour la mise en UInt32 forme de la valeur actuelle, par exemple le symbole de séparateur de groupes ou le symbole de virgule décimale.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt32 value, such as the group separator symbol or the decimal point symbol. Il existe trois façons d’utiliser le provider paramètre pour fournir des informations de mise en ToString(String, IFormatProvider) forme à la méthode:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Vous pouvez passer un CultureInfo objet qui représente la culture qui fournit les informations de mise en forme.You can pass a CultureInfo object that represents the culture that supplies formatting information. Sa GetFormat méthode retourne l' NumberFormatInfo objet qui fournit des informations de mise en forme numérique pour cette culture.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Vous pouvez passer l’objet NumberFormatInfo réel qui fournit des informations de mise en forme numérique.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Son implémentation de GetFormat retourne simplement lui-même.)(Its implementation of GetFormat just returns itself.)

  • Vous pouvez passer un objet personnalisé qui implémente IFormatProvider.You can pass a custom object that implements IFormatProvider. Sa GetFormat méthode instancie et retourne l' NumberFormatInfo objet qui fournit les informations de mise en forme.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Si provider NumberFormatInfo a nullla valeur, la mise en forme de la chaîne retournée est basée sur l’objet de la culture actuelle.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Voir aussi

ToString(String) ToString(String) ToString(String) 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é.Converts the numeric value of this instance to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Paramètres

format
String String String String

Chaîne de format numérique.A numeric format string.

Retours

Représentation sous forme de chaîne de la valeur de cette instance, comme indiqué par format.The string representation of the value of this instance as specified by format.

Exceptions

Le paramètre format n'est pas valide.The format parameter is invalid.

Exemples

L’exemple suivant affiche une valeur d’entier non signé 32 bits à l’aide de chaque chaîne de format standard et de certaines chaînes de format personnalisées.The following example displays a 32-bit unsigned integer value by using each standard format string and some custom format strings.

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
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UInteger = 2179608 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' 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 ToString(String) méthode met en UInt32 forme une valeur dans un format spécifié à NumberFormatInfo l’aide d’un objet qui représente les conventions de la culture actuelle.The ToString(String) method formats a UInt32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Si vous souhaitez utiliser le format par défaut (« G » ou général) ou spécifier une autre culture, utilisez les autres surcharges de la ToString méthode, comme suit :If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)

Le format paramètre peut être n’importe quelle chaîne de format numérique standardvalide, ou n’importe quelle combinaison de chaînes de format numériques personnalisées.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Si format est égal à String.Empty ou a nullla valeur, la valeur de retour UInt32 de l’objet actuel est mise en forme avec le spécificateur de format général (« G »).If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). Si format est une autre valeur, la méthode lève une FormatException.If format is any other value, the method throws a FormatException.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Le format de la chaîne retournée est déterminé par NumberFormatInfo l’objet pour la culture actuelle.The format of the returned string is determined by the NumberFormatInfo object for the current culture. En fonction du format paramètre, cet objet contrôle les symboles tels que le séparateur de groupes et le symbole de virgule décimale dans la chaîne de sortie.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Pour fournir des informations de mise en forme pour les cultures autres que la culture ToString(String, IFormatProvider) actuelle, appelez la surcharge.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Voir aussi

ToString() ToString() ToString() ToString()

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retours

Représentation sous forme de chaîne de la valeur de cette instance, constituée d'une séquence de chiffres entre 0 et 9, sans signe ni zéro non significatif.The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.

Exemples

L’exemple suivant affiche une UInt32 valeur à l’aide de ToString() la méthode par défaut.The following example displays a UInt32 value by using the default ToString() method. Il affiche également les représentations sous forme de UInt32 chaîne de la valeur qui résulte de l’utilisation de certains spécificateurs de format standard.It also displays the string representations of the UInt32 value that results from using some standard format specifiers. Les exemples sont affichés à l’aide des conventions de mise en forme de la culture en-US.The examples are displayed using the formatting conventions of the en-US culture.

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
Module Example
   Public Sub Main()
      Dim value As UInteger = 1632490
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,16}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' 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 ToString() méthode met en UInt32 forme une valeur dans le format par défaut (« G » ou général) à NumberFormatInfo l’aide de l’objet de la culture actuelle.The ToString() method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Si vous souhaitez spécifier un autre format ou une autre culture, utilisez les autres surcharges de ToString la méthode, comme suit:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)
Voir aussi

S’applique à