UInt32.ToString Метод

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

public override string ToString ();

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

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

Примеры

В следующем примере отображается значение UInt32 с помощью метода ToString() по умолчанию. В нем также отображаются строковые представления значения UInt32, которое приводит к использованию некоторых описателей стандартного формата. Примеры отображаются с помощью соглашений о форматировании языка и региональных параметров en-US.

using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // 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:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA

Комментарии

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

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

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

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

Параметры

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

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

Реализации

Примеры

В следующем примере форматирует 16-разрядное целое число со знаком с помощью нескольких поставщиков формата, включая один для инвариантного языка и региональных параметров. Выходные данные из примера показывают, что форматированная строка, возвращаемая методом 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 }; 
      uint value = 1870924;
      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
//           1870924        1870924        1870924

Комментарии

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

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

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

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

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

public string ToString (string format);

public string ToString (string? format);

Параметры

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

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

Исключения

Примеры

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

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      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: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608

Комментарии

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

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

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

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

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

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

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

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

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

Исходный код:

UInt32.cs

public string ToString (string format, IFormatProvider provider);

public string ToString (string? format, IFormatProvider? provider);

Параметры

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

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

Реализации

Исключения

Примеры

В следующем примере отображается 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"}; 
      uint value = 2222402;
      
      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:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942

Комментарии

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

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

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

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

• Дополнительные сведения о форматировании см. в типов форматирования.

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