BigInteger.ToString Méthode

Définition

Espace de noms:: System.Numerics

Assemblys:: System.Numerics.dll, System.Runtime.Numerics.dll

Assemblys:: netstandard.dll, System.Runtime.Numerics.dll

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

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.

Convertit la valeur numérique de l’objet actuel BigInteger en sa représentation sous forme de chaîne équivalente.

Surcharges

Nom	Description
ToString()	Convertit la valeur numérique de l’objet actuel BigInteger en sa représentation sous forme de chaîne équivalente.
ToString(IFormatProvider)	Convertit la valeur numérique de l’objet actuel BigInteger en sa représentation sous forme de chaîne équivalente à l’aide des informations de mise en forme spécifiques à la culture spécifiées.
ToString(String)	Convertit la valeur numérique de l’objet actuel BigInteger 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 l’objet actuel BigInteger 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:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convertit la valeur numérique de l’objet actuel BigInteger en sa représentation sous forme de chaîne équivalente.

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retours

String

Représentation sous forme de chaîne de la valeur actuelle BigInteger .

Exemples

L’exemple suivant affiche une BigInteger valeur à l’aide de la méthode par défaut ToString() . Il affiche également les représentations sous forme de chaîne de la BigInteger valeur résultant 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.

// 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.
    let value = BigInteger.Add(UInt64.MaxValue, 1024)

    // Display value using the default ToString method.
    printfn $"{value.ToString()}"
    // Display value using some standard format specifiers.
    printfn $"""{value.ToString("G")}"""
    printfn $"""{value.ToString("C")}"""
    printfn $"""{value.ToString("D")}"""
    printfn $"""{value.ToString("F")}"""
    printfn $"""{value.ToString("N")}"""
    printfn $"""{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 ToString() méthode met en forme une BigInteger valeur dans le format « R », ou aller-retour, de la culture actuelle. Si vous souhaitez spécifier un format ou une culture différent, utilisez les autres surcharges de la ToString méthode, comme suit :

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

La représentation sous forme de chaîne de la BigInteger valeur inclut un signe négatif si sa valeur est négative, et une séquence de chiffres compris entre 0 et 9 sans zéros non significatifs. Le signe négatif est défini par l’objet NumberFormatInfo de la culture actuelle.

Voir aussi

S’applique à

ToString(IFormatProvider)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

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

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public 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.

Retours

String

Représentation sous forme de chaîne de la valeur actuelle BigInteger au format spécifié par le provider paramètre.

Exemples

L’exemple suivant instancie un objet personnalisé NumberFormatInfo qui définit l’tilde (~) comme signe négatif. La ToString(IFormatProvider) méthode utilise ensuite l’objet personnalisé NumberFormatInfo pour afficher une valeur négative BigInteger .

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

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

Console.WriteLine(number.ToString(bigIntegerProvider));

let number = bigint 9867857831128L
let number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

let bigIntegerProvider = NumberFormatInfo()
bigIntegerProvider.NegativeSign <- "~"

printfn $"{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 ToString(IFormatProvider) méthode met en forme une BigInteger valeur dans le format « R » ou aller-retour à 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 ToString méthode, comme suit :

Pour utiliser le format	Pour la culture	Utiliser la surcharge
Format aller-retour (« R »)	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 provider paramètre est une IFormatProvider implémentation. 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. Si provider c’est nullle cas, la BigInteger valeur est mise en forme à l’aide de l’objet NumberFormatInfo de la culture actuelle. La seule propriété de l’objet NumberFormatInfo qui contrôle la représentation sous forme de chaîne de la BigInteger valeur à 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.

Le provider paramètre peut être l’un des éléments suivants :

Objet CultureInfo qui représente la culture qui fournit des informations de mise en forme.
Objet NumberFormatInfo qui fournit des informations de mise en forme.
Objet personnalisé qui implémente IFormatProvider. Sa GetFormat méthode retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.

S’applique à

ToString(String)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

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

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(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.

Retours

String

Représentation sous forme de chaîne de la valeur actuelle BigInteger au format spécifié par le format paramètre.

Exceptions

FormatException

format n’est pas une chaîne de format valide.

Exemples

L’exemple suivant initialise une BigInteger valeur et l’affiche à l’aide de chaque chaîne de format standard et de certaines chaînes de format personnalisées.

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)

    // Define a BigInteger value.
    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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 ToString(String) méthode met en forme une BigInteger valeur dans un format spécifié à l’aide d’un NumberFormatInfo objet qui représente les conventions de la culture actuelle. Si vous souhaitez utiliser le format « R », ou aller-retour, ou spécifier une autre culture, utilisez les autres surcharges de la ToString méthode, comme suit :

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

Le format paramètre peut être n’importe quelle chaîne numérique standard valide ou toute combinaison de chaînes de format numérique personnalisées. Si format elle est égale ou égale nullà String.Empty , la valeur de retour de l’objet actuel BigInteger est mise en forme avec le spécificateur de format aller-retour (« R »). S’il format s’agit d’une autre valeur, la méthode lève un 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 :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la prise en charge de la mise en forme dans .NET, consultez Types de mise en forme.

Le format de la chaîne retournée est déterminé par l’objet NumberFormatInfo de la culture actuelle. Selon le format paramètre, cet objet contrôle les symboles tels que le signe négatif, 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 ToString(String, IFormatProvider) surcharge.

Voir aussi

S’applique à

ToString(String, IFormatProvider)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convertit la valeur numérique de l’objet actuel BigInteger 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.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString(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.

provider: IFormatProvider

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

Retours

String

Représentation sous forme de chaîne de la valeur actuelle BigInteger spécifiée par les paramètres et provider les format paramètres.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

format n’est pas une chaîne de format valide.

Exemples

L’exemple suivant initialise une BigInteger valeur et l’affiche à la console à l’aide d’une chaîne de format standard et d’un NumberFormatInfo objet qui définit le tilde (~) comme signe négatif.

// 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.
    let bigIntegerFormatter = NumberFormatInfo()
    bigIntegerFormatter.NegativeSign <- "~"

    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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 ToString(String, IFormatProvider) méthode met en forme une BigInteger valeur dans un format spécifié à l’aide de l’objet NumberFormatInfo d’une culture spécifiée. Si vous souhaitez utiliser le format aller-retour ou les paramètres de culture par défaut, utilisez les autres surcharges de la ToString méthode, comme suit :

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

.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 :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la prise en charge de la mise en forme dans .NET, consultez Types de mise en forme.

Le provider paramètre est une IFormatProvider implémentation. 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. Lorsque la ToString(String, IFormatProvider) méthode est appelée, elle appelle la provider méthode du GetFormat paramètre et la transmet à un Type objet qui représente le NumberFormatInfo type. La GetFormat méthode retourne ensuite l’objet qui fournit des informations pour mettre NumberFormatInfo en forme le value paramètre, comme le symbole de signe négatif, le symbole de séparateur de groupe ou le symbole de virgule décimale. Il existe trois façons d’utiliser le provider paramètre pour fournir des informations de mise en forme à la ToString(String, IFormatProvider) méthode :

Vous pouvez transmettre un CultureInfo objet qui représente la culture qui fournit des informations de mise en forme. Sa GetFormat méthode retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme numériques pour cette culture.
Vous pouvez transmettre l’objet réel NumberFormatInfo qui fournit des informations de mise en forme numérique. (Son implémentation de GetFormat just returns lui-même.)
Vous pouvez passer un objet personnalisé qui implémente IFormatProvider. Sa GetFormat méthode instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.

Si provider c’est nullle cas, 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 à

Rétroaction

Cette page a-t-elle été utile ?

Partager via

BigInteger.ToString Méthode

Définition

Surcharges

ToString()

Retours

Exemples

Remarques

Voir aussi

S’applique à

ToString(IFormatProvider)

Paramètres

Retours

Exemples

Remarques

S’applique à

ToString(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

ToString(String, IFormatProvider)

Paramètres

Retours

Implémente

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Rétroaction