Condividi tramite


UInt64.ToString Metodo

Definizione

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente.

Overload

ToString()

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente.

ToString(IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni sul formato specifiche delle impostazioni cultura specificate.

ToString(String)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente utilizzando il formato specificato.

ToString(String, IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura.

ToString()

Origine:
UInt64.cs
Origine:
UInt64.cs
Origine:
UInt64.cs

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente.

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

Restituisce

Rappresentazione di stringa del valore di questa istanza, costituita da una sequenza di cifre compresa tra 0 e 9, senza segno o zeri iniziali.

Esempio

Nell'esempio seguente viene visualizzato un valore UInt64 usando il metodo ToString() predefinito. Vengono inoltre visualizzate le rappresentazioni di stringa del valore UInt64 risultante dall'uso di alcuni identificatori di formato standard. Gli esempi vengono visualizzati usando le convenzioni di formattazione delle impostazioni cultura en-US.

using System;

public class Example
{
   public static void Main()
   {
      ulong value = 163249057;
      // 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:
//       163249057
//       
//       G format specifier:        163249057
//       C format specifier:  $163,249,057.00
//       D format specifier:        163249057
//       F format specifier:     163249057.00
//       N format specifier:   163,249,057.00
//       X format specifier:          9BAFBA1
let value = 163249057uL
// Display value using default ToString method.
printfn $"{value.ToString()}\n"      

// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
    printfn $"{format} format specifier: {value.ToString format,16}" 
// The example displays the following output:
//       163249057
//       
//       G format specifier:        163249057
//       C format specifier:  $163,249,057.00
//       D format specifier:        163249057
//       F format specifier:     163249057.00
//       N format specifier:   163,249,057.00
//       X format specifier:          9BAFBA1
Module Example
   Public Sub Main()
      Dim value As ULong = 163249057
      ' 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:
'       163249057
'       
'       G format specifier:        163249057
'       C format specifier:  $163,249,057.00
'       D format specifier:        163249057
'       F format specifier:     163249057.00
'       N format specifier:   163,249,057.00
'       X format specifier:          9BAFBA1

Commenti

Il metodo ToString() formatta un valore UInt64 nel formato predefinito ("G" o generale) usando l'oggetto NumberFormatInfo delle impostazioni cultura correnti. Se si desidera specificare un formato o impostazioni cultura diverse, usare gli altri overload del metodo ToString, come indicato di seguito:

Per usare il formato Per le impostazioni cultura Usare l'overload
Formato predefinito ("G") Impostazioni cultura specifiche ToString(IFormatProvider)
Formato specifico Impostazioni cultura predefinite (correnti) ToString(String)
Formato specifico Impostazioni cultura specifiche ToString(String, IFormatProvider)

Vedi anche

Si applica a

ToString(IFormatProvider)

Origine:
UInt64.cs
Origine:
UInt64.cs
Origine:
UInt64.cs

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni sul formato specifiche delle impostazioni cultura specificate.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
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

Parametri

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

Rappresentazione di stringa del valore di questa istanza, costituita da una sequenza di cifre compresa tra 0 e 9, senza segno o zeri iniziali.

Implementazioni

Esempio

Nell'esempio seguente viene formattato un valore intero con segno a 64 bit usando diversi provider di formato, tra cui uno per le impostazioni cultura invarianti. L'output dell'esempio illustra che la stringa formattata restituita dal metodo ToString(IFormatProvider) è la stessa indipendentemente dal provider di formato.

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 }; 
      ulong value = 18709243;
      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
//          18709243       18709243       18709243
open System.Globalization

let getName (ci: CultureInfo) =
    if ci.Equals CultureInfo.InvariantCulture then "Invariant"
    else ci.Name

// Define an array of CultureInfo objects.
let ci = 
    [| CultureInfo "en-US" 
       CultureInfo "fr-FR" 
       CultureInfo.InvariantCulture |]

let value = 18709243uL

printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[2],12}"
printfn $"  {value.ToString ci[0],12}   {value.ToString ci[1],12}   {value.ToString ci[2],12}" 
// The example displays the following output:
//             en-US          fr-FR      Invariant
//          18709243       18709243       18709243
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 ULong = 18709243
      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
'          18709243       18709243       18709243

Commenti

Il metodo ToString(IFormatProvider) formatta un valore UInt64 nel formato predefinito ("G" o generale) usando l'oggetto NumberFormatInfo di impostazioni cultura specificate. Se si desidera specificare un formato diverso o le impostazioni cultura correnti, usare gli altri overload del metodo ToString, come indicato di seguito:

Per usare il formato Per le impostazioni cultura Usare l'overload
Formato predefinito ("G") Impostazioni cultura predefinite (correnti) ToString()
Formato specifico Impostazioni cultura predefinite (correnti) ToString(String)
Formato specifico Impostazioni cultura specifiche ToString(String, IFormatProvider)

Il parametro provider è un'implementazione IFormatProvider. Il metodo GetFormat restituisce un oggetto NumberFormatInfo che fornisce informazioni di formattazione specifiche delle impostazioni cultura. Tuttavia, nessuna delle proprietà del NumberFormatInfo viene usata durante la formattazione con l'identificatore di formato numerico generale ("G").

Vedi anche

Si applica a

ToString(String)

Origine:
UInt64.cs
Origine:
UInt64.cs
Origine:
UInt64.cs

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente utilizzando il formato specificato.

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

Parametri

format
String

Stringa di formato numerico.

Restituisce

Rappresentazione di stringa del valore di questa istanza come specificato da format.

Eccezioni

Il parametro format non è valido.

Esempio

Nell'esempio seguente viene visualizzato un valore intero senza segno a 64 bit usando ogni stringa di formato standard e alcune stringhe di formato personalizzate.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ulong value = 217960834;
      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: 217960834
//       C: $217,960,834.00
//       D3: 217960834
//       E2: 2.18E+008
//       e3: 2.180e+008
//       F: 217960834.00
//       N: 217,960,834.00
//       P: 21,796,083,400.00 %
//       X: CFDD182
//       000000.0: 217960834.0
//       #.0: 217960834.0
//       00000000;(0);**Zero**: 217960834
let value = 217960834uL
let specifiers = 
    [| "G"; "C"; "D3"; "E2"; "e3"; "F" 
       "N"; "P"; "X"; "000000.0"; "#.0" 
       "00000000(0)**Zero**" |]
      
for specifier in specifiers do
    printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       G: 217960834
//       C: $217,960,834.00
//       D3: 217960834
//       E2: 2.18E+008
//       e3: 2.180e+008
//       F: 217960834.00
//       N: 217,960,834.00
//       P: 21,796,083,400.00 %
//       X: CFDD182
//       000000.0: 217960834.0
//       #.0: 217960834.0
//       00000000(0)**Zero**: 217960834
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As ULong = 217960834 
      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: 217960834
'       C: $217,960,834.00
'       D3: 217960834
'       E2: 2.18E+008
'       e3: 2.180e+008
'       F: 217960834.00
'       N: 217,960,834.00
'       P: 21,796,083,400.00 %
'       X: CFDD182
'       000000.0: 217960834.0
'       #.0: 217960834.0
'       00000000;(0);**Zero**: 217960834

Commenti

Il metodo ToString(String) formatta un valore UInt64 in un formato specificato utilizzando un oggetto NumberFormatInfo che rappresenta le convenzioni delle impostazioni cultura correnti. Se si desidera utilizzare il formato predefinito ("G" o generale) o specificare impostazioni cultura diverse, usare gli altri overload del metodo ToString, come indicato di seguito:

Per usare il formato Per le impostazioni cultura Usare l'overload
Formato predefinito ("G") Impostazioni cultura predefinite (correnti) ToString()
Formato predefinito ("G") Impostazioni cultura specifiche ToString(IFormatProvider)
Formato specifico Impostazioni cultura specifiche ToString(String, IFormatProvider)

Il parametro format può essere qualsiasi stringa di formato numerico standard validao qualsiasi combinazione di stringhe di formato numerico personalizzato . Se format è uguale a String.Empty o è null, il valore restituito dell'oggetto UInt64 corrente viene formattato con l'identificatore di formato generale ("G"). Se format è qualsiasi altro valore, il metodo genera un FormatException.

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Il formato della stringa restituita è determinato dall'oggetto NumberFormatInfo per le impostazioni cultura correnti. A seconda del parametro format, questo oggetto controlla simboli come il separatore di gruppo e il simbolo di virgola decimale nella stringa di output. Per fornire informazioni di formattazione per impostazioni cultura diverse dalle impostazioni cultura correnti, chiamare l'overload ToString(String, IFormatProvider).

Vedi anche

Si applica a

ToString(String, IFormatProvider)

Origine:
UInt64.cs
Origine:
UInt64.cs
Origine:
UInt64.cs

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura.

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

Parametri

format
String

Stringa di formato numerico.

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su questa istanza.

Restituisce

Rappresentazione di stringa del valore di questa istanza come specificato da format e provider.

Implementazioni

Eccezioni

Il parametro format non è valido.

Esempio

Nell'esempio seguente viene visualizzato un valore intero senza segno a 32 bit usando gli identificatori di formato numerico standard e un numero di oggetti CultureInfo specifici.

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"};
      ulong value = 22224021;

      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:           22224021
//        G format using fr-FR culture:           22224021
//        G format using es-ES culture:           22224021
//
//        C format using en-US culture:     $22,224,021.00
//        C format using fr-FR culture:    22 224 021,00 €
//        C format using es-ES culture:    22.224.021,00 €
//
//       D4 format using en-US culture:           22224021
//       D4 format using fr-FR culture:           22224021
//       D4 format using es-ES culture:           22224021
//
//       E2 format using en-US culture:          2.22E+007
//       E2 format using fr-FR culture:          2,22E+007
//       E2 format using es-ES culture:          2,22E+007
//
//        F format using en-US culture:        22224021.00
//        F format using fr-FR culture:        22224021,00
//        F format using es-ES culture:        22224021,00
//
//        N format using en-US culture:      22,224,021.00
//        N format using fr-FR culture:      22 224 021,00
//        N format using es-ES culture:      22.224.021,00
//
//        P format using en-US culture: 2,222,402,100.00 %
//        P format using fr-FR culture: 2 222 402 100,00 %
//        P format using es-ES culture: 2.222.402.100,00 %
//
//       X2 format using en-US culture:            1531C95
//       X2 format using fr-FR culture:            1531C95
//       X2 format using es-ES culture:            1531C95
open System.Globalization

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US"
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
let value = 22224021uL

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 18}"
    printfn ""
// The example displays the following output:
//        G format using en-US culture:           22224021
//        G format using fr-FR culture:           22224021
//        G format using es-ES culture:           22224021
//
//        C format using en-US culture:     $22,224,021.00
//        C format using fr-FR culture:    22 224 021,00 €
//        C format using es-ES culture:    22.224.021,00 €
//
//       D4 format using en-US culture:           22224021
//       D4 format using fr-FR culture:           22224021
//       D4 format using es-ES culture:           22224021
//
//       E2 format using en-US culture:          2.22E+007
//       E2 format using fr-FR culture:          2,22E+007
//       E2 format using es-ES culture:          2,22E+007
//
//        F format using en-US culture:        22224021.00
//        F format using fr-FR culture:        22224021,00
//        F format using es-ES culture:        22224021,00
//
//        N format using en-US culture:      22,224,021.00
//        N format using fr-FR culture:      22 224 021,00
//        N format using es-ES culture:      22.224.021,00
//
//        P format using en-US culture: 2,222,402,100.00 %
//        P format using fr-FR culture: 2 222 402 100,00 %
//        P format using es-ES culture: 2.222.402.100,00 %
//
//       X2 format using en-US culture:            1531C95
//       X2 format using fr-FR culture:            1531C95
//       X2 format using es-ES culture:            1531C95
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 ULong = 22224021

      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:           22224021
'        G format using fr-FR culture:           22224021
'        G format using es-ES culture:           22224021
'
'        C format using en-US culture:     $22,224,021.00
'        C format using fr-FR culture:    22 224 021,00 €
'        C format using es-ES culture:    22.224.021,00 €
'
'       D4 format using en-US culture:           22224021
'       D4 format using fr-FR culture:           22224021
'       D4 format using es-ES culture:           22224021
'
'       E2 format using en-US culture:          2.22E+007
'       E2 format using fr-FR culture:          2,22E+007
'       E2 format using es-ES culture:          2,22E+007
'
'        F format using en-US culture:        22224021.00
'        F format using fr-FR culture:        22224021,00
'        F format using es-ES culture:        22224021,00
'
'        N format using en-US culture:      22,224,021.00
'        N format using fr-FR culture:      22 224 021,00
'        N format using es-ES culture:      22.224.021,00
'
'        P format using en-US culture: 2,222,402,100.00 %
'        P format using fr-FR culture: 2 222 402 100,00 %
'        P format using es-ES culture: 2.222.402.100,00 %
'
'       X2 format using en-US culture:            1531C95
'       X2 format using fr-FR culture:            1531C95
'       X2 format using es-ES culture:            1531C95

Commenti

Il metodo ToString(String, IFormatProvider) formatta un valore UInt64 in un formato specificato utilizzando l'oggetto NumberFormatInfo di impostazioni cultura specificate. Se si desidera usare le impostazioni predefinite per il formato o le impostazioni cultura, usare gli altri overload del metodo ToString, come indicato di seguito:

Per usare il formato Per le impostazioni cultura Usare l'overload
Formato predefinito ("G") Impostazioni cultura predefinite (correnti) ToString()
Formato predefinito ("G") Impostazioni cultura specifiche ToString(IFormatProvider)
Formato specifico Impostazioni cultura predefinite (correnti) ToString(String)

Il parametro format può essere qualsiasi stringa di formato numerico standard validao qualsiasi combinazione di stringhe di formato numerico personalizzato . Se format è uguale a String.Empty o è null, il valore restituito dell'oggetto UInt64 corrente viene formattato con l'identificatore di formato generale ("G"). Se format è qualsiasi altro valore, il metodo genera un FormatException.

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Il parametro provider è un'implementazione IFormatProvider. Il metodo GetFormat restituisce un oggetto NumberFormatInfo che fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo. Quando viene richiamato il metodo ToString(String, IFormatProvider), chiama il metodo IFormatProvider.GetFormat del parametro provider e lo passa a un oggetto Type che rappresenta il tipo di NumberFormatInfo. Il metodo GetFormat restituisce quindi l'oggetto NumberFormatInfo che fornisce informazioni per la formattazione del valore UInt64 corrente, ad esempio il simbolo separatore di gruppo o il simbolo di virgola decimale. Esistono tre modi per usare il parametro provider per fornire informazioni di formattazione al metodo ToString(String, IFormatProvider):

  • È possibile passare un oggetto CultureInfo che rappresenta le impostazioni cultura che forniscono informazioni di formattazione. Il metodo GetFormat restituisce l'oggetto NumberFormatInfo che fornisce informazioni sulla formattazione numerica per tali impostazioni cultura.

  • È possibile passare l'oggetto NumberFormatInfo effettivo che fornisce informazioni sulla formattazione numerica. L'implementazione di GetFormat restituisce solo se stessa.

  • È possibile passare un oggetto personalizzato che implementa IFormatProvider. Il metodo GetFormat crea un'istanza e restituisce l'oggetto NumberFormatInfo che fornisce informazioni di formattazione.

Se provider è null, la formattazione della stringa restituita si basa sull'oggetto NumberFormatInfo delle impostazioni cultura correnti.

Vedi anche

Si applica a