UInt64.ToString Metoda

Definice

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

Přetížení

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

Převede číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí zadaného formátu.Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.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);
public string ToString (IFormatProvider? provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parametry

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.An object that supplies culture-specific formatting information.

Návraty

String

Řetězcová reprezentace hodnoty této instance, která se skládá z sekvence číslic od 0 do 9 bez znaménka nebo úvodní nuly.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

Příklady

Následující příklad formátuje 64 celočíselnou hodnotu se znaménkem na základě několika poskytovatelů formátu, včetně jednoho pro invariantní jazykovou verzi.The following example formats a 64-bit signed integer value by using several format providers, including one for the invariant culture. Výstup z příkladu znázorňuje, že formátovaný řetězec vrácený ToString(IFormatProvider) metodou je stejný bez ohledu na poskytovatele formátu.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

Poznámky

ToString(IFormatProvider)Metoda formátuje UInt64 hodnotu ve výchozím formátu ("G" nebo "Obecné") pomocí NumberFormatInfo objektu zadané jazykové verze.The ToString(IFormatProvider) method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Pokud chcete zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení ToString metody, jak je znázorněno níže:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

providerParametr je IFormatProvider implementace.The provider parameter is an IFormatProvider implementation. Jeho GetFormat Metoda vrátí NumberFormatInfo objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Nicméně žádná z vlastností není NumberFormatInfo použita při formátování pomocí specifikátoru obecného číselného formátu ("G").However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Viz také

Platí pro

ToString(String, IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi.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);
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

Řetězec číselného formátu.A numeric format string.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi k této instanci.An object that supplies culture-specific formatting information about this instance.

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak je uvedeno v poli format a provider .The string representation of the value of this instance as specified by format and provider.

Implementuje

Výjimky

formatParametr je neplatný.The format parameter is invalid.

Příklady

Následující příklad zobrazuje hodnotu 32 unsigned integer pomocí specifikátoru standardního číselného formátu a množství specifických CultureInfo objektů.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

Poznámky

ToString(String, IFormatProvider)Metoda formátuje UInt64 hodnotu v zadaném formátu pomocí NumberFormatInfo objektu zadané jazykové verze.The ToString(String, IFormatProvider) method formats a UInt64 value in a specified format by using the NumberFormatInfo object of a specified culture. Pokud chcete použít výchozí formát nebo nastavení jazykové verze, použijte další přetížení ToString metody, jak je znázorněno níže:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)

formatParametr může být libovolný platný standardní číselný formátovací řetězecnebo libovolná kombinace vlastních číselných formátovacích řetězců.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Pokud format je rovno String.Empty nebo je null , návratová hodnota aktuálního UInt64 objektu je formátována pomocí obecného specifikátoru formátu ("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"). Pokud format je jakákoli jiná hodnota, vyvolá metoda FormatException .If format is any other value, the method throws a FormatException.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr je IFormatProvider implementace.The provider parameter is an IFormatProvider implementation. Jeho GetFormat Metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické jazykové verze o formátu řetězce vráceného touto metodou.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Při ToString(String, IFormatProvider) vyvolání metody volá provider IFormatProvider.GetFormat metodu parametru a předá jí Type objekt, který představuje NumberFormatInfo typ.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. GetFormatMetoda pak vrátí NumberFormatInfo objekt, který poskytuje informace pro formátování aktuální UInt64 hodnoty, jako je například symbol oddělovače skupiny nebo symbol desetinné čárky.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. Existují tři způsoby, jak použít provider parametr k poskytnutí informací o formátování do ToString(String, IFormatProvider) metody:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Můžete předat CultureInfo objekt, který představuje jazykovou verzi poskytující informace o formátování.You can pass a CultureInfo object that represents the culture that supplies formatting information. Jeho GetFormat Metoda vrátí NumberFormatInfo objekt, který poskytuje informace o formátování čísel pro tuto jazykovou verzi.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Můžete předat skutečný NumberFormatInfo objekt, který poskytuje informace o formátování čísel.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Implementace GetFormat jenom vrátí sám sebe.)(Its implementation of GetFormat just returns itself.)

  • Můžete předat vlastní objekt, který implementuje IFormatProvider .You can pass a custom object that implements IFormatProvider. Jeho GetFormat Metoda vytvoří instanci a vrátí NumberFormatInfo objekt, který poskytuje informace o formátování.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Pokud provider je null , formátování vráceného řetězce je založeno na NumberFormatInfo objektu aktuální jazykové verze.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Viz také

Platí pro

ToString(String)

Převede číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí zadaného formátu.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);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parametry

format
String

Řetězec číselného formátu.A numeric format string.

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak Určuje format .The string representation of the value of this instance as specified by format.

Výjimky

formatParametr je neplatný.The format parameter is invalid.

Příklady

Následující příklad zobrazuje 64 hodnotu bitové unsigned integer pomocí každého standardního formátovacího řetězce a některých vlastních formátovacích řetězců.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

Poznámky

ToString(String)Metoda formátuje UInt64 hodnotu v zadaném formátu pomocí NumberFormatInfo objektu, který představuje konvence aktuální jazykové verze.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. Pokud chcete použít výchozí formát ("G", nebo obecný) nebo zadat jinou jazykovou verzi, použijte další přetížení ToString metody, jak je znázorněno níže: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:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

formatParametr může být libovolný platný standardní číselný formátovací řetězecnebo libovolná kombinace vlastních číselných formátovacích řetězců.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Pokud format je rovno String.Empty nebo je null , návratová hodnota aktuálního UInt64 objektu je formátována pomocí obecného specifikátoru formátu ("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"). Pokud format je jakákoli jiná hodnota, vyvolá metoda FormatException .If format is any other value, the method throws a FormatException.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Formát vráceného řetězce je určen NumberFormatInfo objektem pro aktuální jazykovou verzi.The format of the returned string is determined by the NumberFormatInfo object for the current culture. V závislosti na format parametru tento objekt řídí symboly, jako je oddělovač skupin a symbol desetinné čárky ve výstupním řetězci.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Chcete-li poskytnout informace o formátování pro jiné kultury než aktuální jazykovou verzi, zavolejte ToString(String, IFormatProvider) přetížení.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Viz také

Platí pro

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.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

Návraty

String

Řetězcová reprezentace hodnoty této instance, která se skládá z sekvence číslic od 0 do 9 bez znaménka nebo úvodní nuly.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.

Příklady

Následující příklad zobrazí UInt64 hodnotu pomocí výchozí ToString() metody.The following example displays a UInt64 value by using the default ToString() method. Zobrazuje také řetězcové reprezentace UInt64 hodnoty, která je výsledkem použití některých standardních specifikátorů formátu.It also displays the string representations of the UInt64 value that results from using some standard format specifiers. Příklady jsou zobrazeny pomocí konvencí formátování jazykové verze 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

Poznámky

ToString()Metoda formátuje UInt64 hodnotu ve výchozím formátu ("G" nebo "Obecné") pomocí NumberFormatInfo objektu aktuální jazykové verze.The ToString() method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Pokud chcete zadat jiný formát nebo jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Viz také

Platí pro