UInt32.ToString UInt32.ToString UInt32.ToString UInt32.ToString Method

Определение

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.Converts the numeric value of this instance to its equivalent string representation.

Перегрузки

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата.Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.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 string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Параметры

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.An object that supplies culture-specific formatting information.

Возвраты

Строковое представление значения данного экземпляра, состоящее из последовательности цифр от 0 до 9 без знака и нулей в начале.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Реализации

Примеры

Следующий пример форматирует значение 16-разрядное знаковое целое число с помощью нескольких поставщиков форматирования, включая для инвариантного языка и региональных параметров.The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. Выходные данные из примера показывают, что форматируемой строки, возвращаемые ToString(IFormatProvider) метод не зависит от поставщика формата.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 }; 
      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
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 UInteger = 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)))            
      
   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
'      1870924        1870924        1870924

Комментарии

ToString(IFormatProvider) Форматы метода UInt32 значение по умолчанию («G» или общий) формат с помощью NumberFormatInfo объект указанного языка и региональных параметров.The ToString(IFormatProvider) method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Если вы хотите указать другой формат или текущего языка и региональных параметров, используйте другие перегрузки ToString метода, как показано ниже:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Для использования форматаTo use format Для языка и региональных параметровFor culture Используйте перегрузкуUse the overload
Формат по умолчанию («G»)Default ("G") format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString()
Определенный форматA specific format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString(String)
Определенный форматA specific format Определенного языка и региональных параметровA specific culture ToString(String, IFormatProvider)

provider Параметр IFormatProvider реализации.The provider parameter is an IFormatProvider implementation. Его GetFormat возвращает метод NumberFormatInfo объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Однако ни одно из свойств NumberFormatInfo используются при форматировании с помощью описателя общего числового формата («G»).However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Дополнительно

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.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

Параметры

format
String String String String

Строка числового формата.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Объект, который представляет связанную с языком и региональными параметрами информацию о форматировании этого экземпляра.An object that supplies culture-specific formatting information about this instance.

Возвраты

Строковое представление значения данного экземпляра, определяемое параметрами format и provider.The string representation of the value of this instance as specified by format and provider.

Реализации

Исключения

Параметр format является недопустимым.The format parameter is invalid.

Примеры

Следующий пример отображает значение 32-разрядного целого числа без знака с использованием описателей стандартных числовых форматов и ряд конкретных 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"}; 
      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
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 UInteger = 2222402
      
      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:            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 объект указанного языка и региональных параметров.The ToString(String, IFormatProvider) method formats a UInt32 value in a specified format by using the NumberFormatInfo object of a specified culture. Если вы хотите использовать параметры формата или языка и региональных параметров по умолчанию, использовать другие перегрузки ToString метода, как показано ниже:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Для использования форматаTo use format Для языка и региональных параметровFor culture Используйте перегрузкуUse the overload
Формат по умолчанию («G»)Default ("G") format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString()
Формат по умолчанию («G»)Default ("G") format Определенного языка и региональных параметровA specific culture ToString(IFormatProvider)
Определенный форматA specific format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString(String)

format Параметр может быть любым допустимым строки стандартных числовых форматов, или любое сочетание строки настраиваемых числовых форматов.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Если format равен String.Empty или null, возвращаемое значение текущего UInt32 объект форматируется с помощью описателя общего формата («G»).If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). Если format задано любое другое значение, вызывает метод FormatException.If format is any other value, the method throws a FormatException.

.NET Framework предоставляет широкую поддержку форматирования, который описан более подробно в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider Параметр IFormatProvider реализации.The provider parameter is an IFormatProvider implementation. Его GetFormat возвращает метод NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом для конкретного языка и региональных параметров.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Когда ToString(String, IFormatProvider) вызывается метод, он вызывает метод provider параметра IFormatProvider.GetFormat метод и передает его Type , представляющий 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. GetFormat Метод затем возвращает NumberFormatInfo объект, который предоставляет информацию о форматировании текущего UInt32 значение, например символ-разделитель групп или символ десятичной запятой.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt32 value, such as the group separator symbol or the decimal point symbol. Существует три способа использования provider указать сведения о форматировании для ToString(String, IFormatProvider) метод:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Вы можете передать CultureInfo , представляющий язык и региональные параметры, который предоставляет сведения о форматировании.You can pass a CultureInfo object that represents the culture that supplies formatting information. Его GetFormat возвращает метод NumberFormatInfo объект, предоставляющий сведения о форматировании числовых для этого языка и региональных параметров.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Вы можете передать фактический NumberFormatInfo объект, предоставляющий сведения о форматировании числовых.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Его реализации GetFormat просто возвращает сам себя.)(Its implementation of GetFormat just returns itself.)

  • Можно передать пользовательский объект, реализующий IFormatProvider.You can pass a custom object that implements IFormatProvider. Его GetFormat метод создает экземпляр и возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Если providernull, форматированием возвращаемой строки зависит от NumberFormatInfo объект текущего языка и региональных параметров.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Дополнительно

ToString(String) ToString(String) ToString(String) ToString(String)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата.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

Параметры

format
String String String String

Строка числового формата.A numeric format string.

Возвраты

Строковое представление значения данного экземпляра, определяемое параметром format.The string representation of the value of this instance as specified by format.

Исключения

Параметр format является недопустимым.The format parameter is invalid.

Примеры

Следующий пример отображает значение 32-разрядного целого числа без знака с использованием каждой строки стандартного формата и некоторых строк настраиваемого формата.The following example displays a 32-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()
   {
      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
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UInteger = 2179608 
      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: 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 , представляющий соглашения текущих региональных параметров.The ToString(String) method formats a UInt32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Если вы хотите использовать значение по умолчанию («G» или общий) форматирования или укажите другой язык и региональные параметры, используйте другие перегрузки ToString метода, как показано ниже: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:

Для использования форматаTo use format Для языка и региональных параметровFor culture Используйте перегрузкуUse the overload
Формат по умолчанию («G»)Default ("G") format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString()
Формат по умолчанию («G»)Default ("G") format Определенного языка и региональных параметровA specific culture ToString(IFormatProvider)
Определенный форматA specific format Определенного языка и региональных параметровA specific culture ToString(String, IFormatProvider)

format Параметр может быть любым допустимым строки стандартных числовых форматов, или любое сочетание строки настраиваемых числовых форматов.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Если format равен String.Empty или null, возвращаемое значение текущего UInt32 объект форматируется с помощью описателя общего формата («G»).If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). Если format задано любое другое значение, вызывает метод FormatException.If format is any other value, the method throws a FormatException.

.NET Framework предоставляет широкую поддержку форматирования, который описан более подробно в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Формат возвращаемой строки определяется NumberFormatInfo объект для текущего языка и региональных параметров.The format of the returned string is determined by the NumberFormatInfo object for the current culture. В зависимости от format параметр, этот объект определяет символы, такие как разделители групп и символом десятичной запятой в выходной строке.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего языка и региональных параметров, вызовите ToString(String, IFormatProvider) перегрузки.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Дополнительно

ToString() ToString() ToString() ToString()

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.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

Возвраты

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

Примеры

В следующем примере отображается UInt32 значение по умолчанию ToString() метод.The following example displays a UInt32 value by using the default ToString() method. Она также отображает строковые представления UInt32 значение, в результате использования некоторых описателей стандартного формата.It also displays the string representations of the UInt32 value that results from using some standard format specifiers. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров en US.The examples are displayed using the formatting conventions of the en-US culture.

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
Module Example
   Public Sub Main()
      Dim value As UInteger = 1632490
      ' 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:
'       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 объект текущего языка и региональных параметров.The ToString() method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Если вы хотите указать другой формат или язык и региональные параметры, используйте другие перегрузки ToString метода, как показано ниже:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Для использования форматаTo use format Для языка и региональных параметровFor culture Используйте перегрузкуUse the overload
Формат по умолчанию («G»)Default ("G") format Определенного языка и региональных параметровA specific culture ToString(IFormatProvider)
Определенный форматA specific format (Текущего) язык и региональные параметры по умолчаниюDefault (current) culture ToString(String)
Определенный форматA specific format Определенного языка и региональных параметровA specific culture ToString(String, IFormatProvider)
Дополнительно

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