UInt64.ToString Metoda

Definicja

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

Przeciążenia

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia, składający się z sekwencji cyfr od 0 do 9, bez znaku lub zera wiodącego.The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Implementuje

Przykłady

Poniższy przykład formatuje 64-bitową liczbę całkowitą ze znakiem przy użyciu kilku dostawców formatów, łącznie z jedną dla niezmiennej kultury.The following example formats a 64-bit signed integer value by using several format providers, including one for the invariant culture. Dane wyjściowe z przykładu przedstawiają, że sformatowany ciąg zwracany przez metodę ToString(IFormatProvider) jest taka sama niezależnie od dostawcy formatu.The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      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
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

Uwagi

Metoda ToString(IFormatProvider) formatuje wartość UInt64 w formacie domyślnym ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo określonej kultury.The ToString(IFormatProvider) method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń metody ToString w następujący sposób:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

provider parametr jest implementacją IFormatProvider.The provider parameter is an IFormatProvider implementation. Metoda GetFormat zwraca obiekt NumberFormatInfo, który dostarcza informacje o formatowaniu specyficzne dla kultury.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Jednak żadna z właściwości NumberFormatInfo nie jest używana podczas formatowania z ogólnym specyfikatorem formatu liczbowego ("G").However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Zobacz też

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

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

Parametry

format
String

Ciąg formatu liczbowego.A numeric format string.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu tego wystąpienia specyficzne dla kultury.An object that supplies culture-specific formatting information about this instance.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format i provider.The string representation of the value of this instance as specified by format and provider.

Implementuje

Wyjątki

Parametr format jest nieprawidłowy.The format parameter is invalid.

Przykłady

Poniższy przykład przedstawia 32-bitową liczbę całkowitą bez znaku przy użyciu standardowych specyfikatorów formatu liczbowego i wielu określonych obiektów CultureInfo.The following example displays a 32-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      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
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

Uwagi

Metoda ToString(String, IFormatProvider) formatuje wartość UInt64 w określonym formacie przy użyciu obiektu NumberFormatInfo określonej kultury.The ToString(String, IFormatProvider) method formats a UInt64 value in a specified format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz użyć domyślnego formatu lub ustawień kultury, użyj innych przeciążeń metody ToString w następujący sposób:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)

Parametr format może być dowolnymi prawidłowymi ciągami standardowego formatu liczblub dowolną kombinacją niestandardowych ciągów formatu liczbowego.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Jeśli format jest równa String.Empty lub jest null, wartość zwracana bieżącego obiektu UInt64 jest formatowana przy użyciu specyfikatora formatu ogólnego ("G").If format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). Jeśli format jest dowolną inną wartością, Metoda generuje FormatException.If format is any other value, the method throws a FormatException.

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider parametr jest implementacją IFormatProvider.The provider parameter is an IFormatProvider implementation. Metoda GetFormat zwraca obiekt NumberFormatInfo, który zawiera informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Gdy metoda ToString(String, IFormatProvider) jest wywoływana, wywołuje metodę IFormatProvider.GetFormat parametru provider i przekazuje ją do obiektu Type, który reprezentuje typ NumberFormatInfo.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Metoda GetFormat następnie zwraca obiekt NumberFormatInfo, który zawiera informacje do formatowania bieżącej wartości UInt64, takich jak symbol separatora grupy lub symbol przecinka dziesiętnego.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt64 value, such as the group separator symbol or the decimal point symbol. Istnieją trzy sposoby używania parametru provider do dostarczania informacji o formatowaniu do metody ToString(String, IFormatProvider):There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Można przekazać obiekt CultureInfo, który reprezentuje kulturę dostarczającą informacje o formatowaniu.You can pass a CultureInfo object that represents the culture that supplies formatting information. Metoda GetFormat zwraca obiekt NumberFormatInfo, który dostarcza informacje o formatowaniu liczb dla tej kultury.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Można przekazać rzeczywisty obiekt NumberFormatInfo, który zawiera informacje o formatowaniu liczb.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Jego implementacja GetFormat po prostu zwraca samą siebie).(Its implementation of GetFormat just returns itself.)

  • Można przekazać obiekt niestandardowy, który implementuje IFormatProvider.You can pass a custom object that implements IFormatProvider. Metoda GetFormat tworzy wystąpienia i zwraca obiekt NumberFormatInfo, który zawiera informacje o formatowaniu.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Jeśli provider jest null, formatowanie zwracanego ciągu jest oparte na obiekcie NumberFormatInfo bieżącej kultury.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Zobacz też

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation using the specified format.

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

Parametry

format
String

Ciąg formatu liczbowego.A numeric format string.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format.The string representation of the value of this instance as specified by format.

Wyjątki

Parametr format jest nieprawidłowy.The format parameter is invalid.

Przykłady

Poniższy przykład przedstawia 64-bitową liczbę całkowitą bez znaku przy użyciu każdego ciągu formatu standardowego i niektórych niestandardowych ciągów formatu.The following example displays a 64-bit unsigned integer value by using each standard format string and some custom format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      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
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

Uwagi

Metoda ToString(String) formatuje wartość UInt64 w określonym formacie przy użyciu obiektu NumberFormatInfo, który reprezentuje konwencje bieżącej kultury.The ToString(String) method formats a UInt64 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń metody ToString w następujący sposób:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Parametr format może być dowolnymi prawidłowymi ciągami standardowego formatu liczblub dowolną kombinacją niestandardowych ciągów formatu liczbowego.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Jeśli format jest równa String.Empty lub jest null, wartość zwracana bieżącego obiektu UInt64 jest formatowana przy użyciu specyfikatora formatu ogólnego ("G").If format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). Jeśli format jest dowolną inną wartością, Metoda generuje FormatException.If format is any other value, the method throws a FormatException.

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Format zwracanego ciągu jest określany przez obiekt NumberFormatInfo dla bieżącej kultury.The format of the returned string is determined by the NumberFormatInfo object for the current culture. W zależności od parametru format ten obiekt kontroluje symbole, takie jak separator grup i symbol przecinka dziesiętnego w ciągu danych wyjściowych.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Aby zapewnić informacje o formatowaniu dla kultur innych niż bieżąca kultura, wywołaj Przeciążenie ToString(String, IFormatProvider).To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Zobacz też

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

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

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia, składający się z sekwencji cyfr od 0 do 9, bez znaku lub zera wiodącego.The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.

Przykłady

Poniższy przykład wyświetla wartość UInt64 przy użyciu domyślnej metody ToString().The following example displays a UInt64 value by using the default ToString() method. Wyświetla również reprezentacje ciągów wartości UInt64, które wynikają z użycia niektórych specyfikatorów formatu standardowego.It also displays the string representations of the UInt64 value that results from using some standard format specifiers. W przykładach jest używana konwencja formatowania kultury en-US.The examples are displayed using the formatting conventions of the en-US culture.

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

Uwagi

Metoda ToString() formatuje wartość UInt64 w formacie domyślnym ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo bieżącej kultury.The ToString() method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń metody ToString w następujący sposób:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Zobacz też

Dotyczy