Int64.TryParse Метод

Определение

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

Перегрузки

TryParse(String, Int64)

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

TryParse(ReadOnlySpan<Char>, Int64)

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

TryParse(String, NumberStyles, IFormatProvider, Int64)

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

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

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

TryParse(String, Int64)

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

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

Параметры

s
String

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

result
Int64

При возвращении этим методом содержит 64-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 64-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.

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

Boolean

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

Примеры

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

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("160519");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      bool success = Int64.TryParse(value, out long number);
      if (success)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      else
      {
         if (value == null) value = "";
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       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.
Module StringParsing
   Public Sub Main()
      TryToParse(Nothing)
      TryToParse("160519")
      TryToParse("9432.0")
      TryToParse("16,667")
      TryToParse("   -322   ")
      TryToParse("+4302")
      TryToParse("(100)")
      TryToParse("01FA")
   End Sub
   
   Private Sub TryToParse(value As String)
      Dim number As Long
      Dim result As Boolean = Int64.TryParse(value, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Else
         If value Is Nothing Then value = "" 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value)
      End If     
   End Sub
End Module
' The example displays the following output to the console:
'       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.

Некоторые строки, которые метод не TryParse(String, Int64) может преобразовать в этом примере:Some of the strings that the TryParse(String, Int64) 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][sign]digits[ws]

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

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.An 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 , используйте TryParse(String, NumberStyles, IFormatProvider, Int64) метод.To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the TryParse(String, NumberStyles, IFormatProvider, Int64) 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. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите TryParse(String, NumberStyles, IFormatProvider, Int64) перегрузку.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, Int64) overload.

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

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

TryParse(ReadOnlySpan<Char>, Int64)

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

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

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий символы, которые представляют преобразуемое число.A span containing the characters representing the number to convert.

result
Int64

При возвращении этим методом содержит 64-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 64-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.

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

Boolean

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

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

TryParse(String, NumberStyles, IFormatProvider, Int64)

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

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

Параметры

s
String

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

style
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

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

result
Int64

При возвращении этим методом содержит 64-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 64-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.

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

Boolean

Значение 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.

Примеры

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

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 = Int64.TryParse(stringToConvert, styles,
                                   provider, out long 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 Long
      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 = Int64.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:

Протокол [$] писать [цифры,] цифры [.fractional_digits] [e [sign] exponential_digits] [ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws]

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

[ws] хексдигитс [ws][ws]hexdigits[ws]

Элементы в квадратных скобках ([и]) являются необязательными.Elements 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

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9. Для fractional_digits допустима только цифра 0.For fractional_digits, only the digit 0 is valid.
,, Разделитель тысяч, зависящий от языка и региональных параметров.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.
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.
хексдигитсhexdigits Последовательность шестнадцатеричных цифр от 0 до f или от 0 до F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Примечание

Все завершающие символы NUL (U + 0000) в 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 ( . ) и fractional_digits элементов.) and fractional_digits elements. Однако fractional_digits должны состоять только из одной или более цифр 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Параметр должен представлять целое число в диапазоне Int64 типа данных без ненулевого дробного компонента.The s parameter must represent an integer within the range of the Int64 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 Элемент Sign в виде круглых скобок, охватывающих числовое значение.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, Sign, тысячных разделителей (,) и десятичной запятой (.).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. Если provider параметр имеет значение null , NumberFormatInfo используется объект для текущего языка и региональных параметров.If provider is null, the NumberFormatInfo object for the current culture is used.

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

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

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

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

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

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий символы, которые представляют преобразуемое число.A span containing the characters representing the number to convert. Диапазон интерпретируется с использованием стиля, указанного в style.The span is interpreted using the style specified by style.

style
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

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

result
Int64

При возвращении этим методом содержит 64-разрядное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.When this method returns, contains the 64-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.

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

Boolean

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

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