BigInteger.ToString Méthode

Définition

Convertit la valeur numérique de l'objet BigInteger actuel dans sa représentation sous forme chaîne équivalente.Converts the numeric value of the current BigInteger object to its equivalent string representation.

Surcharges

ToString()

Convertit la valeur numérique de l'objet BigInteger actuel dans sa représentation sous forme chaîne équivalente.Converts the numeric value of the current BigInteger object to its equivalent string representation.

ToString(IFormatProvider)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente à l’aide des informations spécifiées de mise en forme spécifiques à la culture.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

ToString(String)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

ToString(String, IFormatProvider)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié et des informations de mise en forme spécifiques à la culture.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

ToString()

Convertit la valeur numérique de l'objet BigInteger actuel dans sa représentation sous forme chaîne équivalente.Converts the numeric value of the current BigInteger object 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 actuelle de BigInteger.The string representation of the current BigInteger value.

Exemples

L’exemple suivant affiche une valeur BigInteger à l’aide de la méthode ToString() par défaut.The following example displays a BigInteger value by using the default ToString() method. Il affiche également les représentations sous forme de chaîne de la valeur BigInteger qui résulte de l’utilisation de certains spécificateurs de format standard.It also displays the string representations of the BigInteger 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.

// Initialize a BigInteger value.
BigInteger value = BigInteger.Add(UInt64.MaxValue, 1024);

// Display value using the default ToString method.
Console.WriteLine(value.ToString());     
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));
Console.WriteLine(value.ToString("C"));
Console.WriteLine(value.ToString("D"));
Console.WriteLine(value.ToString("F"));
Console.WriteLine(value.ToString("N"));
Console.WriteLine(value.ToString("X"));       
// The example displays the following output on a system whose current 
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF      
' Initialize a BigInteger value.
Dim value As BigInteger = BigInteger.Add(UInt64.MaxValue, 1024)

' Display value using the default ToString method.
Console.WriteLine(value.ToString())        
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))
Console.WriteLine(value.ToString("C"))
Console.WriteLine(value.ToString("D"))
Console.WriteLine(value.ToString("F"))
Console.WriteLine(value.ToString("N"))
Console.WriteLine(value.ToString("X"))       
' The example displays the following output on a system whose current 
' culture is en-US:
'       18446744073709552639
'       18446744073709552639
'       $18,446,744,073,709,552,639.00
'       18446744073709552639
'       18446744073709552639.00
'       18,446,744,073,709,552,639.00
'       100000000000003FF      

Remarques

La méthode ToString() met en forme une valeur BigInteger dans le format « R » ou aller-retour de la culture actuelle.The ToString() method formats a BigInteger value in the "R", or round-trip, format of the current culture. Si vous souhaitez spécifier un autre format ou une autre culture, utilisez les autres surcharges de la méthode ToString, 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 aller-retour (« R »)Round-trip ("R") format Une culture spécifiqueA specific 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)

La représentation sous forme de chaîne de la valeur BigInteger comprend un signe négatif si sa valeur est négative et une séquence de chiffres allant de 0 à 9 sans zéro non significatif.The string representation of the BigInteger value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. Le signe négatif est défini par l’objet NumberFormatInfo pour la culture actuelle.The negative sign is defined by the NumberFormatInfo object for the current culture.

Voir aussi

ToString(IFormatProvider)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente à l’aide des informations spécifiées de mise en forme spécifiques à la culture.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting 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

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 actuelle de BigInteger au format spécifié par le paramètre provider.The string representation of the current BigInteger value in the format specified by the provider parameter.

Exemples

L’exemple suivant instancie un objet NumberFormatInfo personnalisé qui définit le tilde (~) comme un signe négatif.The following example instantiates a custom NumberFormatInfo object that defines the tilde (~) as a negative sign. La méthode ToString(IFormatProvider) utilise ensuite l’objet NumberFormatInfo personnalisé pour afficher une valeur de BigInteger négative.The ToString(IFormatProvider) method then uses the custom NumberFormatInfo object to display a negative BigInteger value.

BigInteger number = 9867857831128;
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne;

NumberFormatInfo bigIntegerProvider = new NumberFormatInfo();
bigIntegerProvider.NegativeSign = "~";

Console.WriteLine(number.ToString(bigIntegerProvider));
Dim number As BigInteger = 9867857831128
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

Dim bigIntegerProvider As New NumberFormatInfo()
bigIntegerProvider.NegativeSign = "~"      

Console.WriteLine(number.ToString(bigIntegerProvider))

Remarques

La méthode ToString(IFormatProvider) met en forme une valeur BigInteger dans le format « R », ou aller-retour, à l’aide de l’objet NumberFormatInfo d’une culture spécifiée.The ToString(IFormatProvider) method formats a BigInteger value in the "R", or round-trip, 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 méthode ToString, 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 aller-retour (« R »)Round-trip ("R") 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 paramètre provider est une implémentation IFormatProvider.The provider parameter is an IFormatProvider implementation. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Si provider est null, la valeur de BigInteger est mise en forme à l’aide de l’objet NumberFormatInfo de la culture actuelle.If provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. La seule propriété de l’objet NumberFormatInfo qui contrôle la représentation sous forme de chaîne de la valeur BigInteger à l’aide du spécificateur de format général est NumberFormatInfo.NegativeSign, qui définit le caractère qui représente le signe négatif.The only property of the NumberFormatInfo object that controls the string representation of the BigInteger value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

Le paramètre provider peut être l’un des suivants :The provider parameter can be one of the following:

ToString(String)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the numeric value of the current BigInteger object to its equivalent string representation by 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

Chaîne de format numérique standard ou personnalisée.A standard or custom numeric format string.

Retours

Représentation sous forme de chaîne de la valeur actuelle de BigInteger au format spécifié par le paramètre format.The string representation of the current BigInteger value in the format specified by the format parameter.

Exceptions

format n’est pas une chaîne de format valide.format is not a valid format string.

Exemples

L’exemple suivant initialise une valeur BigInteger et l’affiche à l’aide de chaque chaîne de format standard et de certaines chaînes de format personnalisées.The following example initializes a BigInteger value and displays it by using each standard format string and some custom format strings.

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                        "G", "N0", "P", "R", "X", "0,0.000", 
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));

// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)
Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next   
' The example displays the following output:
'       C: ($903,145,792,771,643,190,182.00)
'       D: -903145792771643190182
'       D25: -0000903145792771643190182
'       E: -9.031457E+020
'       E4: -9.0314E+020
'       e8: -9.03145792e+020
'       F0: -903145792771643190182
'       G: -903145792771643190182
'       N0: -903,145,792,771,643,190,182
'       P: -90,314,579,277,164,319,018,200.00 %
'       R: -903145792771643190182
'       X: CF0A55968BB1A7545A
'       0,0.000: -903,145,792,771,643,190,182.000
'       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Remarques

La méthode ToString(String) met en forme une valeur BigInteger dans un format spécifié à l’aide d’un objet NumberFormatInfo qui représente les conventions de la culture actuelle.The ToString(String) method formats a BigInteger value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Si vous souhaitez utiliser le format « R », ou aller-retour, ou spécifier une autre culture, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to use the "R", or round-trip, 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 aller-retour (« R »)Round-trip ("R") format Culture par défaut (actuelle)Default (current) culture ToString()
Format aller-retour (« R »)Round-trip ("R") 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 paramètre format peut être n’importe quelle chaîne 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 string, or any combination of custom numeric format strings. Si format est égal à String.Empty ou est null, la valeur de retour de l’objet BigInteger actuel est mise en forme avec le spécificateur de format aller-retour ("R").If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). 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 l’objet NumberFormatInfo pour la culture actuelle.The format of the returned string is determined by the NumberFormatInfo object for the current culture. Selon le paramètre format, cet objet contrôle les symboles tels que le signe négatif, 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 negative sign, 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 actuelle, appelez la surcharge ToString(String, IFormatProvider).To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Voir aussi

ToString(String, IFormatProvider)

Convertit la valeur numérique de l’objet BigInteger actuel en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié et des informations de mise en forme spécifiques à la culture.Converts the numeric value of the current BigInteger object to its equivalent string representation by 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

Chaîne de format numérique standard ou personnalisée.A standard or custom numeric format string.

provider
IFormatProvider

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

Retours

La représentation sous forme de chaîne de la valeur BigInteger actuelle spécifiée par les paramètres format et provider.The string representation of the current BigInteger value as specified by the format and provider parameters.

Implémente

Exceptions

format n’est pas une chaîne de format valide.format is not a valid format string.

Exemples

L’exemple suivant initialise une BigInteger valeur et l’affiche dans la console à l’aide d’une chaîne de format standard et d’un objet NumberFormatInfo qui définit le tilde (~) comme un signe négatif.The following example initializes a BigInteger value, and displays it to the console using a standard format string and a NumberFormatInfo object that defines the tilde (~) as a negative sign.

// Redefine the negative sign as the tilde for the invariant culture.
NumberFormatInfo bigIntegerFormatter = new NumberFormatInfo();
bigIntegerFormatter.NegativeSign = "~";

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                        "G", "N0", "P", "R", "X", "0,0.000", 
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerFormatter));

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)
' Redefine the negative sign as the tilde for the invariant culture.
Dim bigIntegerFormatter As New NumberFormatInfo()
bigIntegerFormatter.NegativeSign = "~"

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerformatter))
Next   
' The example displays the following output:
'    C: (☼903,145,792,771,643,190,182.00)
'    D: ~903145792771643190182
'    D25: ~0000903145792771643190182
'    E: ~9.031457E+020
'    E4: ~9.0314E+020
'    e8: ~9.03145792e+020
'    F0: ~903145792771643190182
'    G: ~903145792771643190182
'    N0: ~903,145,792,771,643,190,182
'    P: ~90,314,579,277,164,319,018,200.00 %
'    R: ~903145792771643190182
'    X: CF0A55968BB1A7545A
'    0,0.000: ~903,145,792,771,643,190,182.000
'    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Remarques

La méthode ToString(String, IFormatProvider) met en forme une valeur BigInteger dans un format spécifié à l’aide de l’objet NumberFormatInfo d’une culture spécifiée.The ToString(String, IFormatProvider) method formats a BigInteger value in a specified format by using the NumberFormatInfo object of a specified culture. Si vous souhaitez utiliser le format aller-retour ou les paramètres de culture par défaut, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to use the round-trip format or default 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 aller-retour (« R »)Round-trip ("R") format Culture par défaut (actuelle)Default (current) culture ToString()
Format aller-retour (« R »)Round-trip ("R") 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 paramètre format peut être n’importe quelle chaîne 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 string, or any combination of custom numeric format strings. Si format est égal à String.Empty ou est null, la valeur de retour de l’objet BigInteger actuel est mise en forme avec le spécificateur de format aller-retour ("R").If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). 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 paramètre provider est une implémentation IFormatProvider.The provider parameter is an IFormatProvider implementation. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Lorsque la méthode ToString(String, IFormatProvider) est appelée, elle appelle la méthode GetFormat du paramètre provider et la passe à un objet Type qui représente le type NumberFormatInfo.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. La méthode GetFormat retourne alors l’objet NumberFormatInfo qui fournit des informations pour la mise en forme du paramètre value, tel que le symbole de signe négatif, 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 value parameter, such as the negative sign symbol, the group separator symbol, or the decimal point symbol. 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) :There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Vous pouvez passer un objet CultureInfo 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 méthode GetFormat retourne l’objet NumberFormatInfo 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 se 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 méthode GetFormat instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

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.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Voir aussi

S’applique à