Int32.TryParse Int32.TryParse Int32.TryParse Int32.TryParse Method

Определение

Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком.Converts the string representation of a number to its 32-bit signed integer equivalent. Возвращает значение, указывающее, успешно ли выполнена операция.A return value indicates whether the operation succeeded.

Перегрузки

TryParse(String, Int32) TryParse(String, Int32) TryParse(String, Int32) TryParse(String, Int32)

Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком.Converts the string representation of a number to its 32-bit signed integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32)
TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32)

Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком.Converts the string representation of a number in a specified style and culture-specific format to its 32-bit signed integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32)

TryParse(String, Int32) TryParse(String, Int32) TryParse(String, Int32) TryParse(String, Int32)

Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком.Converts the string representation of a number to its 32-bit signed integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] int % result);
public static bool TryParse (string s, out int result);
static member TryParse : string *  -> bool
Public Shared Function TryParse (s As String, ByRef result As Integer) As Boolean

Параметры

s
String String String String

Строка, содержащая преобразуемое число.A string containing a number to convert.

result
Int32 Int32 Int32 Int32

При возвращении этим методом содержит 32-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 32-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается сбоем, если параметр s равен null или Empty, не находится в правильном формате или представляет число меньше MinValue или больше MaxValue.The conversion fails if the s parameter is null or Empty, is not of the correct format, or represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Примеры

В следующем примере вызывается Int32.TryParse(String, Int32) метод с количеством разных строковых значений.The following example calls the Int32.TryParse(String, Int32) method with a number of different string values.

using namespace System;


   void TryToParse(String^ value)
   {
      Int32 number;
      bool result = Int32::TryParse(value, number);
      if (result) {
         Console::WriteLine("Converted '{0}' to {1}.", value, number);
      }
      else {
         if (value == nullptr) value = "";
         Console::WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }


void main()
{
      TryToParse(nullptr);
      TryToParse("160519");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
}
// The example displays the following output:
//      Attempted conversion of '' failed.
//      Converted '160519' to 160519.
//      Attempted conversion of '9432.0' failed.
//      Attempted conversion of '16,667' failed.
//      Converted '   -322   ' to -322.
//      Converted '+4302' to 4302.
//      Attempted conversion of '(100);' failed.
//      Attempted conversion of '01FA' failed.
using System;

public class Example
{
   public static void Main()
   {
      String[] values = { null, "160519", "9432.0", "16,667",
                          "   -322   ", "+4302", "(100);", "01FA" };
      foreach (var value in values) 
      {
         int number;
   
         bool success = Int32.TryParse(value, out number);
         if (success)
         {
            Console.WriteLine("Converted '{0}' to {1}.", value, number);         
         }
         else
         {
            Console.WriteLine("Attempted conversion of '{0}' failed.", 
                               value ?? "<null>");
         }
      }
   }
}
// The example displays the following output:
//       Attempted conversion of '<null>' failed.
//       Converted '160519' to 160519.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100);' failed.
//       Attempted conversion of '01FA' failed.
Module Example
   Public Sub Main()
      Dim values() As String = { Nothing, "160519", "9432.0", "16,667",
                                 "   -322   ", "+4302", "(100);", 
                                 "01FA" }

      For Each value In values
         Dim number As Integer
    
         Dim success As Boolean = Int32.TryParse(value, number)
         If success Then
            Console.WriteLine("Converted '{0}' to {1}.", value, number)
         Else
            Console.WriteLine("Attempted conversion of '{0}' failed.", 
                              If(value ,"<null>"))
         End If     
      Next
   End Sub
End Module
' The example displays the following output to the console:
'       Attempted conversion of '<null>' failed.
'       Converted '160519' to 160519.
'       Attempted conversion of '9432.0' failed.
'       Attempted conversion of '16,667' failed.
'       Converted '   -322   ' to -322.
'       Converted '+4302' to 4302.
'       Attempted conversion of '(100)' failed.
'       Attempted conversion of '01FA' failed.

Некоторые из строк, TryParse(String, Int32) метод не удается преобразовать в этом примере являются:Some of the strings that the TryParse(String, Int32) method is unable to convert in this example are:

  • "9432.0"."9432.0". Преобразование завершается неудачей, так как строка не может содержать десятичный разделитель; он должен содержать только цифры целой части.The conversion fails because the string cannot contain a decimal separator; it must contain integral digits only.

  • "16,667"."16,667". Преобразование завершается неудачей, так как строка не может содержать разделители групп; он должен содержать только цифры целой части.The conversion fails because the string cannot contain group separators; it must contain integral digits only.

  • "(100)"."(100)". Преобразование завершается неудачей, так как строка не может содержать знак "минус", отличной от той, определение текущего языка и региональных параметров NumberFormatInfo.NegativeSign и NumberFormatInfo.NumberNegativePattern свойства.The conversion fails because the string cannot contain a negative sign other than the one defined by the current culture's NumberFormatInfo.NegativeSign and NumberFormatInfo.NumberNegativePattern properties.

  • «01FA»."01FA". Преобразование завершается неудачей, так как строка не может содержать шестнадцатеричных цифр; он должен содержать только десятичные цифры.The conversion fails because the string cannot contain hexadecimal digits; it must contain decimal digits only.

Комментарии

TryParse Метод аналогичен Parse метода, за исключением TryParse метод не выдает исключение, если преобразование завершается неудачей.The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails. Это устраняет необходимость использования обработки исключений для проверки FormatException в случае недоступности s является недопустимым и не может быть успешно обработан.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

s Параметр содержит ряд формы:The s parameter contains a number of the form:

[ws] [вход] цифр [ws][ws][sign]digits[ws]

Элементы в квадратных скобках ([и]) являются необязательными.Items in square brackets ([ and ]) are optional. Каждый из элементов описан в таблице ниже.The following table describes each element.

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space.
signsign Необязательный знак.An optional sign.
digitsdigits Последовательность цифр в диапазоне от 0 до 9.A sequence of digits ranging from 0 to 9.

s Параметр интерпретируется с использованием NumberStyles.Integer стиля.The s parameter is interpreted using the NumberStyles.Integer style. Помимо десятичных разрядов допускаются только начальные и конечные пробелы, а также знак в начале.In addition to the decimal digits, only leading and trailing spaces together with a leading sign are allowed. Чтобы явно определить элементы стиля вместе с языком и региональными параметрами сведения об особенностях форматирования, могут быть представлены в s, используйте Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) метод.To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) method.

s Параметр анализируется с использованием сведений о форматировании в NumberFormatInfo объект инициализирован для текущего языка и региональных параметров системы.The s parameter is parsed using the formatting information in a NumberFormatInfo object initialized for the current system culture. Дополнительные сведения см. в разделе CurrentInfo.For more information, see CurrentInfo.

Эта перегрузка TryParse метод интерпретирует все цифры s параметра в виде десятичных цифр.This overload of the TryParse method interprets all digits in the s parameter as decimal digits. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) перегрузки.To parse the string representation of a hexadecimal number, call the Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) overload.

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

TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32) TryParse(ReadOnlySpan<Char>, Int32)

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] int % result);
public static bool TryParse (ReadOnlySpan<char> s, out int result);
static member TryParse : ReadOnlySpan<char> *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Integer) As Boolean

Параметры

Возвраты

TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32) TryParse(String, NumberStyles, IFormatProvider, Int32)

Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком.Converts the string representation of a number in a specified style and culture-specific format to its 32-bit signed integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] int % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out int result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider *  -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Integer) As Boolean

Параметры

s
String String String String

Строка, содержащая преобразуемое число.A string containing a number to convert. Строка интерпретируется с использованием стиля, указанного в style.The string is interpreted using the style specified by style.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Побитовое сочетание значений перечисления, обозначающих элементы стиля, которые могут быть представлены в параметре s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Обычно указывается значение Integer.A typical value to specify is Integer.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

result
Int32 Int32 Int32 Int32

При возвращении этим методом содержит 32-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 32-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается сбоем, если параметр s равен null или Empty, не находится в формате, совместимом с style или представляет собой число меньше MinValue или больше MaxValue.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Исключения

style не является значением NumberStyles.style is not a NumberStyles value.

-или--or- style не является сочетанием значений AllowHexSpecifier и HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Примеры

В следующем примере вызывается Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) метод с количеством другую строку и NumberStyles значения.The following example calls the Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) method with a number of different string and NumberStyles values.

using namespace System;
using namespace System::Globalization;

void CallTryParse(String^ stringToConvert, NumberStyles styles)
{
      Int32 number;
      CultureInfo^ provider;

      // If currency symbol is allowed, use en-US culture. 
      if (((Int32) (styles & NumberStyles::AllowCurrencySymbol)) > 0)
         provider = gcnew CultureInfo("en-US");
      else
         provider = CultureInfo::InvariantCulture;

      bool result = Int32::TryParse(stringToConvert, styles, 
                                   provider, number);
      if (result)
         Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console::WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert::ToString(stringToConvert));
}

void main()
{
      String^ numericString;
      NumberStyles styles;

      numericString = "106779";
      styles = NumberStyles::Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles::None;
      CallTryParse(numericString, styles);

      styles = NumberStyles::AllowLeadingSign;
      CallTryParse(numericString, styles);

      numericString = "301677-";
      CallTryParse(numericString, styles);

      styles = styles | NumberStyles::AllowTrailingSign;
      CallTryParse(numericString, styles);

      numericString = "$10634";
      styles = NumberStyles::Integer;
      CallTryParse(numericString, styles);

      styles = NumberStyles::Integer | NumberStyles::AllowCurrencySymbol;
      CallTryParse(numericString, styles);

      numericString = "10345.00";
      styles = NumberStyles::Integer | NumberStyles::AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10345.72";
      styles = NumberStyles::Integer | NumberStyles::AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles::Integer | NumberStyles::AllowThousands;
      CallTryParse(numericString, styles);

      numericString = "12E-01";
      styles = NumberStyles::Integer | NumberStyles::AllowExponent;
      CallTryParse(numericString, styles); 

      numericString = "12E03";
      CallTryParse(numericString, styles); 

      numericString = "80c1";
      CallTryParse(numericString, NumberStyles::HexNumber);

      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles::HexNumber);      
      Console::ReadLine();
}
// The example displays the following output:
//      Converted '106779' to 106779.
//      Attempted conversion of '-30677' failed.
//      Converted '-30677' to -30677.
//      Attempted conversion of '301677-' failed.
//      Converted '301677-' to -301677.
//      Attempted conversion of '$10634' failed.
//      Converted '$10634' to 10634.
//      Converted '10345.00' to 10345.
//      Attempted conversion of '10345.72' failed.
//      Converted '22,593' to 22593.
//      Attempted conversion of '12E-01' failed.
//      Converted '12E03' to 12000.
//      Converted '80c1' to 32961.
//      Attempted conversion of '0x80C1' failed.
using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106779";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.AllowLeadingSign;
      CallTryParse(numericString, styles);
      
      numericString = "301677-";
      CallTryParse(numericString, styles);
      
      styles = styles | NumberStyles.AllowTrailingSign;
      CallTryParse(numericString, styles);
      
      numericString = "$10634";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.Integer | NumberStyles.AllowCurrencySymbol;
      CallTryParse(numericString, styles);
      
      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);
      
      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
          
      numericString = "12E03";
      CallTryParse(numericString, styles); 
      
      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);      
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      CultureInfo provider;
      
      // If currency symbol is allowed, use en-US culture.
      if ((styles & NumberStyles.AllowCurrencySymbol) > 0)
         provider = new CultureInfo("en-US");
      else
         provider = CultureInfo.InvariantCulture;
            
      bool success = Int32.TryParse(stringToConvert, styles, 
                                   provider, out int number);
      if (success)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106779"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.AllowLeadingSign
      CallTryParse(numericString, styles)
      
      numericString = "301677-"
      CallTryParse(numericString, styles)
      
      styles = styles Or NumberStyles.AllowTrailingSign
      CallTryParse(numericString, styles)
      
      numericString = "$10634"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.Integer Or NumberStyles.AllowCurrencySymbol
      CallTryParse(numericString, styles)

      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Integer
      Dim provider As CultureInfo
      
      ' If currency symbol is allowed, use en-US culture.
      If CBool(styles And NumberStyles.AllowCurrencySymbol) Then
         provider = CultureInfo.CurrentCulture
      Else
         provider = New CultureInfo("en-US")
      End If
      
      Dim result As Boolean = Int32.TryParse(stringToConvert, styles, _
                                             provider, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '106779' to 106779.
'       Attempted conversion of '-30677' failed.
'       Converted '-30677' to -30677.
'       Attempted conversion of '301677-' failed.
'       Converted '301677-' to -301677.
'       Attempted conversion of '$10634' failed.
'       Converted '$10634' to 10634.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to 32961.
'       Attempted conversion of '0x80C1' failed.

Комментарии

TryParse Метод аналогичен Parse метода, за исключением TryParse метод не выдает исключение, если преобразование завершается неудачей.The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails. Это устраняет необходимость использования обработки исключений для проверки FormatException в случае недоступности s является недопустимым и не может быть успешно обработан.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be parsed successfully.

style Параметр определяет элементы стиля (например, пробелы и знак плюс или минус), которые разрешены в s параметр для успешного выполнения операции синтаксического анализа.The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the s parameter for the parse operation to succeed. Он должен представлять собой сочетание битовых флагов из NumberStyles перечисления.It must be a combination of bit flags from the NumberStyles enumeration. В зависимости от значения style, s параметр может содержать следующие элементы:Depending on the value of style, the s parameter may include the following elements:

[ws] [$] [вход] [цифр], цифрами [.fractional_digits] [цифр e [вход]] [ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]digits][ws]

Или, если style включает параметр AllowHexSpecifier:Or, if the style parameter includes AllowHexSpecifier:

[ws] hexdigits [ws][ws]hexdigits[ws]

Элементы в квадратных скобках ([и]) являются необязательными.Items in square brackets ([ and ]) are optional. Каждый из элементов описан в таблице ниже.The following table describes each element.

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space. Пробелы могут отображаться в начале s Если style включает в себя NumberStyles.AllowLeadingWhite флаг, или в конце s Если style включает в себя NumberStyles.AllowTrailingWhite флаг.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Символ валюты.A culture-specific currency symbol. Его положение в строке определяется CurrencyPositivePattern свойство NumberFormatInfo объект, возвращаемый GetFormat метод provider параметра.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Символ валюты может встречаться в s Если style включает в себя NumberStyles.AllowCurrencySymbol флаг.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Необязательный знак.An optional sign. Символ знака может встречаться в s Если style включает в себя NumberStyles.AllowLeadingSign или NumberStyles.AllowTrailingSign флаги.A sign symbol can appear in s if style includes the NumberStyles.AllowLeadingSign or NumberStyles.AllowTrailingSign flags.
digitsdigits Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9.
,, Разделителя групп разрядов разделителя.A culture-specific thousands separator. Тысяч разделитель языка и региональных параметров, заданные provider могут присутствовать в s Если style включает в себя NumberStyles.AllowThousands флаг.The thousands separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Символ десятичной запятой для конкретного языка и региональных параметров.A culture-specific decimal point symbol. Символ десятичной запятой, языка и региональных параметров, заданные provider могут присутствовать в s Если style включает в себя NumberStyles.AllowDecimalPoint флаг.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits Один или несколько вхождений цифры 0.One or more occurrences of the digit 0. Дробных разрядов может встречаться в s только если style включает в себя NumberStyles.AllowDecimalPoint флаг.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee «E» или «E» знаком, который указывает, что значение будет представлено в экспоненциальной нотации.The 'e' or 'E' character, which indicates that the value is represented in exponential notation. s Параметр может представлять число в экспоненциальном представлении, если style включает в себя NumberStyles.AllowExponent флаг.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Последовательность шестнадцатеричных цифр от 0 до f или от 0 до F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Примечание

Символы (от U + 0000) завершающий NUL в s пропускаются операцией анализа, независимо от значения style аргумент.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Строка только десятичных знаков (который соответствует NumberStyles.None флаг) всегда успешно выполняет синтаксический анализ.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Большинство оставшихся NumberStyles члены управляют элементы, которые, возможно, но необязательно должны присутствовать в этом входной строки.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. В следующей таблице показаны как отдельные NumberStyles члены влияют на элементы, которые могут присутствовать в s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Простые значения NumberStylesNon-composite NumberStyles values Допустимые элементы s помимо цифрElements permitted in s in addition to digits
NumberStyles.None Только десятичные цифры.Decimal digits only.
NumberStyles.AllowDecimalPoint Десятичной запятой (.) и цифры_дробной_части элементов.The decimal point (.) and fractional_digits elements. Тем не менее цифры_дробной_части должен включать только один или несколько цифр 0 или этот метод возвращает false.However, fractional_digits must consist of only one or more 0 digits or the method returns false.
NumberStyles.AllowExponent s Параметр можно также использовать экспоненциальное представление.The s parameter can also use exponential notation. Если s представляет число в экспоненциальном представлении, он должен быть целым числом в диапазоне Int32 тип данных без ненулевой дробного компонента.If s represents a number in exponential notation, it must represent an integer within the range of the Int32 data type without a non-zero, fractional component.
NumberStyles.AllowLeadingWhite Ws элемент в начале s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Ws элемент в конце s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Знак может располагаться перед цифр.A sign can appear before digits.
NumberStyles.AllowTrailingSign Знак может располагаться после цифр.A sign can appear after digits.
NumberStyles.AllowParentheses Входа элемент в скобки, заключив числовое значение.The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands Тысяч разделителя (,) элемент.The thousands separator (,) element.
NumberStyles.AllowCurrencySymbol $ Элемент.The $ element.
NumberStyles.Currency Все элементы.All elements. s Параметра не может представлять шестнадцатеричное число или число в экспоненциальном представлении.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
NumberStyles.Float Ws элемент в начале или конце s, входа в начале sи десятичной запятой (.) символов.The ws element at the beginning or end of s, sign at the beginning of s, and the decimal point (.) symbol. s Параметр можно также использовать экспоненциальное представление.The s parameter can also use exponential notation.
NumberStyles.Number Ws, входа, тысячи разделителя (,) и десятичной запятой (.) элементов.The ws, sign, thousands separator (,), and decimal point (.) elements.
NumberStyles.Any Все стили, кроме s не может представлять шестнадцатеричное число.All styles, except s cannot represent a hexadecimal number.

Если NumberStyles.AllowHexSpecifier флага s должен представлять собой шестнадцатеричное значение без префикса.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Например «C9AF3» успешно выполняет синтаксический анализ, но не поддерживает «0xC9AF3».For example, "C9AF3" parses successfully, but "0xC9AF3" does not. Только другие флаги, которые могут быть представлены в style являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. ( NumberStyles Перечисление имеет составной стиль NumberStyles.HexNumber, включающий в себя оба флага пробелы.)(The NumberStyles enumeration has a composite style, NumberStyles.HexNumber, that includes both white space flags.)

provider Параметр IFormatProvider реализации, такие как CultureInfo объекта или NumberFormatInfo , чье свойство GetFormat возвращает метод NumberFormatInfo объекта.The provider parameter is an IFormatProvider implementation, such as a CultureInfo object or a NumberFormatInfo object, whose GetFormat method returns a NumberFormatInfo object. NumberFormatInfo Предоставляет зависящие от культуры сведения о формате параметра s.The NumberFormatInfo object provides culture-specific information about the format of s. Если providernull, NumberFormatInfo объект для текущего языка и региональных параметров.If provider is null, the NumberFormatInfo object for the current culture is used.

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

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int32)

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] int % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out int result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Integer) As Boolean

Параметры

Возвраты

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