Partager via


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.

Surcharges

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.

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

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.

ToString()

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

ToString(String, IFormatProvider)

Source:
BigInteger.cs
Source:
BigInteger.cs
Source:
BigInteger.cs

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.

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

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

Implémente

Exceptions

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)
Format spécifique Culture par défaut (actuelle) ToString(String)

Le format paramètre peut être n’importe quelle chaîne numérique standard valide ou n’importe quelle 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 actif BigInteger est mise en forme avec le spécificateur de format aller-retour (« R »). Si format est 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 :

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 lui transmet un Type objet qui représente le NumberFormatInfo type. La GetFormat méthode retourne ensuite l’objet NumberFormatInfo qui fournit des informations pour la mise en forme du value paramètre, telles que le symbole de signe négatif, le symbole de séparateur de groupe ou le symbole décimal. 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 passer 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érique pour cette culture.

  • Vous pouvez passer l’objet réel NumberFormatInfo 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 GetFormat méthode 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 à

ToString(String)

Source:
BigInteger.cs
Source:
BigInteger.cs
Source:
BigInteger.cs

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

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

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

Exceptions

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 « R », ou l’aller-retour, mettre en forme 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)
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 n’importe quelle 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 actif BigInteger est mise en forme avec le spécificateur de format aller-retour (« R »). Si format est 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 :

Le format de la chaîne retournée est déterminé par l’objet NumberFormatInfo de la culture actuelle. En fonction du format paramètre, cet objet contrôle des 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 des cultures autres que la culture actuelle, appelez la ToString(String, IFormatProvider) surcharge.

Voir aussi

S’applique à

ToString(IFormatProvider)

Source:
BigInteger.cs
Source:
BigInteger.cs
Source:
BigInteger.cs

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.

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

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

Exemples

L’exemple suivant instancie un objet personnalisé NumberFormatInfo qui définit le tilde (~) comme un 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 au format « R », ou aller-retour, à l’aide de l’objet NumberFormatInfo d’une culture spécifiée. Si vous souhaitez spécifier un autre format 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()
Format spécifique Culture par défaut (actuelle) ToString(String)
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 a la valeur null, 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 valeur à l’aide BigInteger 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 suivants :

S’applique à

ToString()

Source:
BigInteger.cs
Source:
BigInteger.cs
Source:
BigInteger.cs

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

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.

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 qui résulte de l’utilisation de certains 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 au format « R », ou aller-retour, de la culture actuelle. Si vous souhaitez spécifier un autre format ou 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 ») 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 pour la culture actuelle.

Voir aussi

S’applique à