UInt64.ToString Метод

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.

Перегрузки

ToString()	Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.
ToString(IFormatProvider)	Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанные сведения о формате, зависящее от языка и региональных параметров.
ToString(String)	Преобразует числовое значение этого экземпляра в эквивалентное строковое представление с помощью указанного формата.
ToString(String, IFormatProvider)	Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат и сведения о формате, зависящее от языка и региональных параметров.

ToString()

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Возвращаемое значение

String

Строковое представление значения этого экземпляра, состоящее из последовательности цифр, начиная от 0 до 9, без знака или начальных нулей.

Примеры

В следующем примере отображается значение UInt64 с помощью метода ToString() по умолчанию. В нем также отображаются строковые представления значения UInt64, которое приводит к использованию некоторых описателей стандартного формата. Примеры отображаются с помощью соглашений о форматировании языка и региональных параметров 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

Метод ToString() форматирует значение UInt64 в формате по умолчанию ("G" или общего) с помощью объекта NumberFormatInfo текущего языка и региональных параметров. Если вы хотите указать другой формат или региональные параметры, используйте другие перегрузки метода ToString следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

См. также раздел

Parse(String)
Типы форматирования в .NET

Применяется к

ToString(IFormatProvider)

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанные сведения о формате, зависящее от языка и региональных параметров.

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

Параметры

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.

Возвращаемое значение

String

Реализации

ToString(IFormatProvider)

Примеры

В следующем примере форматирует 64-разрядное целое число со знаком с помощью нескольких поставщиков формата, включая один для инвариантного языка и региональных параметров. Выходные данные из примера показывают, что форматированная строка, возвращаемая методом ToString(IFormatProvider), одинакова независимо от поставщика формата.

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

Метод ToString(IFormatProvider) форматирует значение UInt64 в формате по умолчанию ("G" или общего) с помощью объекта NumberFormatInfo указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (current)	ToString()
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

Параметр provider — это реализация IFormatProvider. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров. Однако ни одно из свойств NumberFormatInfo не используется при форматировании с помощью общего описатель числового формата ("G").

См. также раздел

Parse(String)
Типы форматирования в .NET

Применяется к

ToString(String)

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Преобразует числовое значение этого экземпляра в эквивалентное строковое представление с помощью указанного формата.

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

Параметры

format: String

Строка числового формата.

Возвращаемое значение

String

Строковое представление значения этого экземпляра, указанного format.

Исключения

FormatException

Недопустимый параметр format.

Примеры

В следующем примере отображается 64-разрядное целое число без знака с помощью каждой стандартной строки формата и некоторых пользовательских строк форматирования.

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

Метод ToString(String) форматирует значение UInt64 в указанном формате с помощью объекта NumberFormatInfo, представляющего соглашения текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию (G или общие) или указать другой язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (current)	ToString()
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

Параметр может быть любым допустимым строк стандартно го числового форматаили любой комбинацией строк пользовательского числового формата. Если format равно String.Empty или null, возвращаемое значение текущего объекта UInt64 отформатировано с помощью общего описателя формата ("G"). Если format является любым другим значением, метод создает FormatException.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:

Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о поддержке форматирования в .NET см. в типах форматирования.

Формат возвращаемой строки определяется объектом NumberFormatInfo для текущего языка и региональных параметров. В зависимости от параметра format этот объект управляет символами, такими как разделитель групп и символ десятичной запятой в выходной строке. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего языка и региональных параметров, вызовите перегрузку ToString(String, IFormatProvider).

См. также раздел

Parse(String)
Типы форматирования в .NET
How to: Pad a Number with Leading Zeros

Применяется к

ToString(String, IFormatProvider)

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Исходный код:: UInt64.cs

Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат и сведения о формате, зависящее от языка и региональных параметров.

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

Параметры

format: String

Строка числового формата.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании данного экземпляра, зависящий от языка и региональных параметров.

Возвращаемое значение

String

Строковое представление значения этого экземпляра, указанное format и provider.

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

Недопустимый параметр format.

Примеры

В следующем примере отображается 32-разрядное целое значение без знака с помощью описателей стандартного числового формата и ряда конкретных объектов CultureInfo.

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

Метод ToString(String, IFormatProvider) форматирует значение UInt64 в указанном формате с помощью объекта NumberFormatInfo заданного языка и региональных параметров. Если вы хотите использовать параметры формата по умолчанию или языка и региональных параметров, используйте другие перегрузки метода ToString следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (current)	ToString()
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)

Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.

Параметр provider — это реализация IFormatProvider. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о формате строки, возвращаемой этим методом. При вызове метода ToString(String, IFormatProvider) вызывается метод IFormatProvider.GetFormat параметра provider и передает его объект Type, представляющий тип NumberFormatInfo. Затем метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании текущего значения UInt64, например символа разделителя групп или десятичного символа. Существует три способа использования параметра provider для предоставления сведений о форматировании методу ToString(String, IFormatProvider):

Можно передать объект CultureInfo, представляющий язык и региональные параметры, предоставляющие сведения о форматировании. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий числовые сведения о форматировании для этого языка и региональных параметров.
Можно передать фактический объект NumberFormatInfo, предоставляющий числовые сведения о форматировании. (Его реализация GetFormat просто возвращается.)
Можно передать пользовательский объект, реализующий IFormatProvider. Его метод GetFormat создает экземпляр и возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.

Если providernull, форматирование возвращаемой строки основано на объекте NumberFormatInfo текущего языка и региональных параметров.

См. также раздел

Parse(String)
Типы форматирования в .NET
How to: Pad a Number with Leading Zeros
пример: служебная программа форматирования WinForms .NET Core (C#)
пример : служебная программа форматирования WinForms .NET Core (Visual Basic)

Применяется к

Поделиться через

UInt64.ToString Метод

Определение

Перегрузки

ToString()

Возвращаемое значение

Примеры

Комментарии

См. также раздел

Применяется к

ToString(IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Примеры

Комментарии

См. также раздел

Применяется к

ToString(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToString(String, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы