UInt64.TryParse UInt64.TryParse UInt64.TryParse UInt64.TryParse Method

Определение

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

Перегрузки

TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64)

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

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

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

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

TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64)

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS
System.Decimal.Parse(String)

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

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

Параметры

s
String String String String

Строка, представляющая преобразуемое число.A string that represents the number to convert.

result
UInt64 UInt64 UInt64 UInt64

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

Примеры

В следующем примере вызывается TryParse(String, UInt64) метод один раз для каждого элемента в массиве строк.The following example calls the TryParse(String, UInt64) method once for each element in a string array.

string[] numericStrings = { "1293.8", "+1671.7", "28347.", 
                            "   33113684  ", "(0)", "-0", "+1293617", 
                            "18-", "119870", "31,024", "  3127094 ",  
                            "00700000" };
ulong number;
foreach (string numericString in numericStrings)
{
   if (UInt64.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt64.
//       Cannot convert '+1671.7' to a UInt64.
//       Cannot convert '28347.' to a UInt64.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt64.
//       Converted '-0' to 0.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt64.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt64.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", _
                                  "   33113684  ", "(0)", "-0", "+1293617", _
                                  "18-", "119870", "31,024", "  3127094 ", _ 
                                  "0070000" }
Dim number As ULong
For Each numericString As String In numericStrings
   If UInt64.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt64.
'       Cannot convert '+1671.7' to a UInt64.
'       Cannot convert '28347.' to a UInt64.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt64.
'       Converted '-0' to 0.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt64.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt64.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

Комментарии

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

s Параметр должен иметь строковое представление десятичного числа в следующей форме:The s parameter should be the string representation of a decimal number in the following form:

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

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

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space.
signsign Необязательный знак.An optional sign. Допустимые знаки определяются по NumberFormatInfo.NegativeSign и NumberFormatInfo.PositiveSign свойства текущего языка и региональных параметров.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
digitsdigits Последовательность десятичных цифр от 0 до 9.A sequence of decimal digits ranging from 0 to 9.

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

Примечание

Строкой, указанной параметром s параметр не может содержать разделители групп или десятичного разделителя, и он не может иметь дробную часть.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a fractional portion.

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

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

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

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

Важно!

Этот API несовместим с CLS.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt64 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ulong result);
static member TryParse : ReadOnlySpan<char> *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As ULong) As Boolean

Параметры

Возвраты

TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64)

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS
System.Decimal.Parse(String)

Предпринимает попытку преобразовать строковое представление числа в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное 64-битовое целое число без знака.Tries to convert the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned 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] System::UInt64 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong 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 ULong) As Boolean

Параметры

s
String String String String

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

style
NumberStyles NumberStyles NumberStyles NumberStyles

Побитовая комбинация значений перечисления, которая показывает разрешенный формат параметра s.A bitwise combination of enumeration values that indicates the permitted format of 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
UInt64 UInt64 UInt64 UInt64

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

Примеры

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

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "2106034";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103674.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "41792210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC86DA1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ulong number;
      bool result = UInt64.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         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:
//       Converted '2106034' to 2106034.
//       Attempted conversion of '-10603' failed.
//       Converted '29103674.00' to 29103674.
//       Attempted conversion of '10345.72' failed.
//       Converted '41792210E-01' to 4179221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC86DA1' to 4291325345.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "2106034"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103674.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "41792210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC86DA1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As ULong
      Dim result As Boolean = UInt64.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, 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 '2106034' to 2106034.
'       Attempted conversion of '-10603' failed.
'       Converted '29103674.00' to 29103674.
'       Attempted conversion of '10345.72' failed.
'       Converted '41792210E-01' to 4179221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC86DA1' to 4291325345.
'       Attempted conversion of '0x8F8C' failed.

Комментарии

TryParse(String, NumberStyles, IFormatProvider, UInt64) Метод аналогичен Parse(String, NumberStyles, IFormatProvider) за тем исключением, что он не создания исключения, если преобразование завершается неудачей.The TryParse(String, NumberStyles, IFormatProvider, UInt64) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. Этот метод исключает необходимость использовать обработку исключений для проверки FormatException Если s является недопустимым и не может быть успешно обработан.This method eliminates the need to use exception handling to test for a FormatException if 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] [$] [входа] [цифр,]цифр[. цифры_дробной_части] [E [входа]экспоненциальные_цифры] [ws][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

Элементы в квадратных скобках ([и]) являются необязательными.Items in square brackets ([ and ]) are optional. Или, если style включает параметр NumberStyles.AllowHexSpecifier, s параметр может содержать следующие элементы:Or, if the style parameter includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

Каждый из элементов описан в таблице ниже.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 start 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 флаг и может отображаться в конце s Если style включает в себя NumberStyles.AllowTrailingSign флаг.The sign can appear at the start of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Можно использовать скобки в s указывает отрицательное значение, если style включает в себя NumberStyles.AllowParentheses флаг.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Тем не менее, если знак минус отсутствует, s может представлять только значение ноль для успешного выполнения операции синтаксического анализа.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.
digitsdigits Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9.
,, Разделитель групп, зависящий от языка и региональных параметров.A culture-specific group separator. Разделитель групп, языка и региональных параметров, заданные provider могут присутствовать в s Если style включает в себя NumberStyles.AllowThousands флаг.The group 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 (scientific) notation. s Параметр может представлять число в экспоненциальном представлении, если style включает в себя NumberStyles.AllowExponent флаг.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9. 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 present, 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.

Простые NumberStyles значенияNon-composite NumberStyles values Элементы, допустимые в значении помимо цифрElements permitted in value in addition to digits
None Только десятичные цифры.Decimal digits only.
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.
AllowExponent «E» или «E» знаком, который указывает экспоненциальное представление, вместе с экспоненциальные_цифры.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Если s представляет число в экспоненциальном представлении, он не может иметь ненулевое значение дробного компонента.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Ws элемент в начале s.The ws element at the start of s.
AllowTrailingWhite Ws элемент в конце s.The ws element at the end of s.
AllowLeadingSign Входа элемент перед цифр.The sign element before digits.
AllowTrailingSign Входа после элемента цифр.The sign element after digits.
AllowParentheses Входа элемент в скобки, заключив ноль числовое значение.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Разделитель групп (,) элемент.The group separator (,) element.
AllowCurrencySymbol Валюта ($) элемент.The currency ($) element.
Currency Все элементы.All elements. Тем не менее s не может представлять шестнадцатеричное число или число в экспоненциальном представлении.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Ws элемент в начале или конце s, входа в начале sи десятичной запятой (.) символов.The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. s Параметр можно также использовать экспоненциальное представление.The s parameter can also use exponential notation.
Number Ws, входа, разделитель групп (,) и десятичной запятой (.) элементов.The ws, sign, group separator (,), and decimal point (.) elements.
Any Все элементы.All elements. Тем не менее s не может представлять шестнадцатеричное число.However, s cannot represent a hexadecimal number.

Если NumberStyles.AllowHexSpecifier флага s должен представлять собой шестнадцатеричное значение.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Допустимые шестнадцатеричные цифры символы являются 0-9, A-F и a-f.Valid hexadecimal characters are 0-9, A-F, and a-f. Префикс, например «0 x» не поддерживается и приводит к сбою операции синтаксического анализа.A prefix such as "0x" is not supported and causes the parse operation to fail. Только другие флаги, которые могут быть представлены в style являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. ( NumberStyles Перечисление имеет составной стиль HexNumber, включающий в себя оба флага пустого пространства.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Примечание

Если s является строковым представлением шестнадцатеричного числа, он не может начинаться с описателей (таких как 0x или &h), отличающее его как шестнадцатеричное число.If s is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. Это приводит к сбою преобразования.This causes the conversion to fail.

provider Параметр IFormatProvider реализации.The provider parameter is an IFormatProvider implementation. Его GetFormat возвращает NumberFormatInfo объект, который предоставляет зависящие от культуры сведения о формате параметра s.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. provider Параметр может принимать одно из следующих:The provider parameter can be any one of the following:

  • Объект CultureInfo , представляющий язык и региональные параметры, который предоставляет сведения о форматировании.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 объект, предоставляющий сведения о форматировании числовых.A NumberFormatInfo object that provides numeric formatting information. (Его реализации GetFormat просто возвращает сам себя.)(Its implementation of GetFormat just returns itself.)

  • Пользовательский объект, реализующий IFormatProvider.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 NumberFormatInfo object for the current culture is used.

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

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

Важно!

Этот API несовместим с CLS.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong 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 ULong) As Boolean

Параметры

Возвраты

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