UInt16.TryParse 方法

定义

将数字的字符串表示形式转换为它的等效 16 位无符号整数。Converts the string representation of a number to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

重载

TryParse(String, UInt16)

尝试将数字的字符串表示形式转换为等效的 16 位无符号整数。Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt16)

尝试将数字的范围表示形式转换为其等效的 16 位无符号整数。Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, UInt16)

尝试将数字的指定样式和区域性特定格式的字符串表示形式转换为其等效的 16 位无符号整数。Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

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

尝试将指定样式和区域性特定格式的数字的范围表示形式转换为其等效的 16 位无符号整数。Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

TryParse(String, UInt16)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案
System.Int32.TryParse(String, Int32)

尝试将数字的字符串表示形式转换为等效的 16 位无符号整数。Tries to convert the string representation of a number to its 16-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::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out ushort result);
static member TryParse : string * uint16 -> bool
Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean

参数

s
String

表示要转换的数字的字符串。A string that represents the number to convert.

result
UInt16

当此方法返回时,如果转换成功,则包含与 s 中所含数字等效的 16 位无符号整数值;如果转换失败,则包含零。When this method returns, contains the 16-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. 如果 s 参数为 nullEmpty 的格式不正确,则转换失败。The conversion fails if the s parameter is null or Empty, is not in the correct format. ,或者表示小于 MinValue 或大于 MaxValue 的数字。, 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;否则为 falsetrue if s was converted successfully; otherwise, false.

属性

示例

下面的示例为字符串数组中的每个元素调用一次 TryParse(String, UInt16) 方法。The following example calls the TryParse(String, UInt16) method once for each element in a string array.

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

注解

TryParse(String, UInt16) 方法与 Parse(String) 方法类似,不同之处在于,如果转换失败,则它不会引发异常。The TryParse(String, UInt16) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. 如果 s 无效且无法成功分析,则此方法无需使用异常处理来测试 FormatExceptionThis 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][sign]digits[ws][ws][sign]digits[ws]

方括号 ([ and ]) 中的元素是可选的。Elements in square brackets ([ and ]) are optional. 下表对每个元素进行了描述。The following table describes each element.

元素Element 说明Description
wsws 可选空白。Optional white space.
signsign 一个可选的符号。An optional sign. 有效的符号字符由当前区域性的 NumberFormatInfo.NegativeSignNumberFormatInfo.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 参数指定的字符串不能包含任何组分隔符或小数分隔符,并且它不能包含小数部分。The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

使用 NumberStyles.Integer 样式对 s 参数进行解释。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, UInt16) 方法。To explicitly define the style elements with the culture-specific formatting information that can be present in s, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) method.

使用当前系统区域性的 NumberFormatInfo 对象中的格式设置信息对 s 参数进行分析。The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. 有关详细信息,请参阅 NumberFormatInfo.CurrentInfoFor more information, see NumberFormatInfo.CurrentInfo.

此重载将 s 参数中的所有数字解释为十进制数字。This overload interprets all digits in the s parameter as decimal digits. 若要分析十六进制数的字符串表示形式,请改为调用 TryParse(String, NumberStyles, IFormatProvider, UInt16) 重载。To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) overload instead.

另请参阅

TryParse(ReadOnlySpan<Char>, UInt16)

重要

此 API 不符合 CLS。

尝试将数字的范围表示形式转换为其等效的 16 位无符号整数。Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. 一个指示转换是否成功的返回值。A return value indicates whether the conversion succeeded or failed.

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

参数

s
ReadOnlySpan<Char>

包含表示要转换的数字的字符的范围。A span containing the characters representing the number to convert.

result
UInt16

当此方法返回时,如果转换成功,则包含与 s 中所含数字等效的 16 位无符号整数值;如果转换失败,则包含零。When this method returns, contains the 16-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. 如果 s 参数为 nullEmpty 的格式不正确,则转换失败。The conversion fails if the s parameter is null or Empty, is not in the correct format. ,或者表示小于 MinValue 或大于 MaxValue 的数字。, 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;否则为 falsetrue if s was converted successfully; otherwise, false.

属性

TryParse(String, NumberStyles, IFormatProvider, UInt16)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案
System.Int32.TryParse(String, Int32)

尝试将数字的指定样式和区域性特定格式的字符串表示形式转换为其等效的 16 位无符号整数。Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-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::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

参数

s
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

枚举值的一个按位组合,指示 s 所允许的格式。A bitwise combination of enumeration values that indicates the permitted format of s. 要指定的一个典型值为 IntegerA typical value to specify is Integer.

provider
IFormatProvider

一个对象,提供有关 s 的区域性特定格式设置信息。An object that supplies culture-specific formatting information about s.

result
UInt16

当此方法返回时,如果转换成功,则包含与 s 中所含数字等效的 16 位无符号整数值;如果转换失败,则包含零。When this method returns, contains the 16-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. 如果 s 参数为 nullEmpty、格式不符合 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;否则为 falsetrue if s was converted successfully; otherwise, false.

属性

异常

style 不是 NumberStyles 值。style is not a NumberStyles value.

-or- style 不是 AllowHexSpecifierHexNumber 值的组合。style is not a combination of AllowHexSpecifier and HexNumber values.

示例

下面的示例使用多个不同的字符串和 NumberStyles 值调用 TryParse(String, NumberStyles, IFormatProvider, UInt16) 方法。The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt16) 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 = "10603";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "2210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ushort number;
      bool result = UInt16.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 '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

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

      numericString = "2210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UShort
      Dim result As Boolean = UInt16.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 '10603' to 10603.
'       Attempted conversion of '-10603' failed.
'       Converted '29103.00' to 29103.
'       Attempted conversion of '10345.72' failed.
'       Converted '2210E-01' to 221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC8' to 65480.
'       Attempted conversion of '0x8F8C' failed.

注解

TryParse(String, NumberStyles, IFormatProvider, UInt16) 方法与 Parse(String, NumberStyles, IFormatProvider) 方法类似,不同之处在于,如果转换失败,则它不会引发异常。The TryParse(String, NumberStyles, IFormatProvider, UInt16) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. 如果 s 无效且无法成功分析,则此方法无需使用异常处理来测试 FormatExceptionThis 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][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

方括号([和])中的项是可选的。Items in square brackets ([ and ]) are optional. 或者,如果 style 参数包括 AllowHexSpecifier,则 s 参数可能包括以下元素:Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

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

下表对每个元素进行了描述。The following table describes each element.

wsws
可选空白。Optional white space. 如果 style 包含 NumberStyles.AllowLeadingWhite 标志,s 或者如果 style 包含 NumberStyles.AllowTrailingWhite 标志,则在 s 的开头可以出现空白。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. 其在字符串中的位置由 provider 参数的 GetFormat 方法返回的 NumberFormatInfo 对象的 CurrencyPositivePattern 属性定义。Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. 如果 style 包含 NumberStyles.AllowCurrencySymbol 标志,货币符号可以出现在 s 中。The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
一个可选的符号。An optional sign. 如果 style 包含 NumberStyles.AllowLeadingSign 标志,则符号会出现在 s 的开头,如果 style 包含 NumberStyles.AllowTrailingSign 标志,则它可以出现在 s 的末尾。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. 如果 style 包含 NumberStyles.AllowParentheses 标志,则可以在 s 中使用括号来表示负值。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. 如果 style 包括 NumberStyles.AllowThousands 标志,则 provider 指定的区域性的组分隔符可以出现在 s 中。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. 如果 style 包括 NumberStyles.AllowDecimalPoint 标志,则 provider 指定的区域性的小数点符号可以出现在 s 中。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. 仅当 style 包含 NumberStyles.AllowDecimalPoint 标志时,小数位才能出现在 s 中。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. 如果 style 包含 NumberStyles.AllowExponent 标志,则 s 参数可以表示指数表示法中的数字。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. 如果 style 包含 NumberStyles.AllowExponent 标志,则 s 参数可以表示指数表示法中的数字。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.

备注

无论 style 参数的值是什么,分析操作都将忽略 s 中任何终止的 NUL (U + 0000)字符。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.

非复合 NumberStylesNon-composite NumberStyles values 除了数字以外,还允许在值中使用元素Elements permitted in value in addition to digits
None 仅十进制数字。Decimal digits only.
AllowDecimalPoint 小数点(.)和fractional_digits元素。The decimal point (.) and fractional_digits elements. fractional_digits只能包含一个或多个0位数,或者该方法返回 falseHowever, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent "E" 或 "E" 字符(指示指数表示法)以及exponential_digitsThe "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 s开头的ws元素。The ws element at the start of s.
AllowTrailingWhite s末尾的ws元素。The ws element at the end of s.
AllowLeadingSign 数字前面的sign元素。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 s开头或结尾处的ws元素,在 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 Wssign、group 分隔符()和小数点(.)元素。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。前缀(如 "0x")不受支持,导致分析操作失败。Valid hexadecimal digits are 0 through 9, a through f, and A through F. A prefix such as "0x" is not supported and causes the parse operation to fail. style 中的唯一其他标志 NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhiteThe 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:

如果 null``provider,则使用当前区域性的 NumberFormatInfo 对象。If provider is null, the NumberFormatInfo object for the current culture is used.

另请参阅

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

重要

此 API 不符合 CLS。

尝试将指定样式和区域性特定格式的数字的范围表示形式转换为其等效的 16 位无符号整数。Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned 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] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

参数

s
ReadOnlySpan<Char>

一个范围,包含表示要转换的数字的字符。A span containing the characters that represent the number to convert. 该范围使用由 style 参数指定的样式来进行解释。The span is interpreted by using the style specified by the style parameter.

style
NumberStyles

枚举值的一个按位组合,指示 s 所允许的格式。A bitwise combination of enumeration values that indicates the permitted format of s. 要指定的一个典型值为 IntegerA typical value to specify is Integer.

provider
IFormatProvider

一个对象,提供有关 s 的区域性特定格式设置信息。An object that supplies culture-specific formatting information about s.

result
UInt16

当此方法返回时,如果转换成功,则包含与 s 中所含数字等效的 16 位无符号整数值;如果转换失败,则包含零。When this method returns, contains the 16-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. 如果 s 参数为 nullEmpty、格式不符合 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;否则为 falsetrue if s was converted successfully; otherwise, false.

属性

适用于