SByte.TryParse 方法

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = IUtf8SpanParsable<System::SByte>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out sbyte result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功分析 utf8Text，则 true;否则，false。

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::SByte % result);

public static bool TryParse(ReadOnlySpan<char> s, out sbyte result);

[System.CLSCompliant(false)]
public static bool TryParse(ReadOnlySpan<char> s, out sbyte result);

static member TryParse : ReadOnlySpan<char> * sbyte -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * sbyte -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As SByte) As Boolean

参数

返回

如果已成功转换 s，则 true;否则，false。

属性

CLSCompliantAttribute

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::SByte % result);

[System.CLSCompliant(false)]
public static bool TryParse(string s, out sbyte result);

public static bool TryParse(string? s, out sbyte result);

[System.CLSCompliant(false)]
public static bool TryParse(string? s, out sbyte result);

[<System.CLSCompliant(false)>]
static member TryParse : string * sbyte -> bool

static member TryParse : string * sbyte -> bool

Public Shared Function TryParse (s As String, ByRef result As SByte) As Boolean

参数

返回

如果已成功转换 s，则 true;否则，false。

属性

CLSCompliantAttribute

示例

以下示例尝试通过调用 TryParse(String, SByte) 方法将数组中的字符串转换为 SByte 值。

string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.

open System

let numericStrings = 
    [| "-3.6"; "12.8"; "+16.7"; "    3   "; "(17)" 
       "-17"; "+12"; "18-"; "987"; "1,024"; "  127 " |]

for numericString in numericStrings do
    match SByte.TryParse numericString with 
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to an SByte."
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.

Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", "    3   ", _
                                  "(17)", "-17", "+12", "18-", "987", _
                                  "1,024", "  127 "}
Dim number As SByte
For Each numericString As String In numericStrings
   If SByte.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
   End If      
Next
' The example displays the following output to the console:
'       Cannot convert '-3.6' to an SByte.
'       Cannot convert '12.8' to an SByte.
'       Cannot convert '+16.7' to an SByte.
'       Converted '    3   ' to 3.
'       Cannot convert '(17)' to an SByte.
'       Converted '-17' to -17.
'       Converted '+12' to 12.
'       Cannot convert '18-' to an SByte.
'       Cannot convert '987' to an SByte.
'       Cannot convert '1,024' to an SByte.
'       Converted '  127 ' to 127.

注解

SByte.TryParse(String, SByte) 方法类似于 SByte.Parse(String) 方法，只是转换失败时不会引发异常。 如果 value 无效且无法成功分析，则此方法无需使用异常处理来测试 FormatException。

s 参数应为十进制数的字符串表示形式，格式如下：

[ws][符号]位[ws]

方括号 （[ 和 ]） 中的元素是可选的。 下表描述了每个元素。

元素	描述
ws	可选空格。
签名	可选符号。 有效符号字符由当前区域性的 NumberFormatInfo.NegativeSign 和 NumberFormatInfo.PositiveSign 属性决定。
位	从 0 到 9 的十进制数字序列。

s 参数使用 NumberStyles.Integer 样式进行解释。 除了十进制数字，还允许使用前导符号的前导和尾随空格。 若要显式定义具有区域性特定的格式设置信息的样式元素，可以在 value中显示，请调用 TryParse(String, NumberStyles, IFormatProvider, SByte) 方法。

s 参数通过使用当前区域性的 NumberFormatInfo 对象中的格式设置信息进行分析。 有关详细信息，请参阅 NumberFormatInfo.CurrentInfo。

此重载将 value 参数中的所有数字解释为十进制数字。 若要分析十六进制数的字符串表示形式，请改为调用 TryParse(String, NumberStyles, IFormatProvider, SByte) 重载。

另请参阅

• 示例：.NET Core WinForms 格式设置实用工具 （C#）
• 示例：.NET Core WinForms 格式设置实用工具 （Visual Basic）

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = ISpanParsable<System::SByte>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out sbyte result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功分析 s，则 true;否则，false。

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = IParsable<System::SByte>::TryParse;

public static bool TryParse(string? s, IFormatProvider? provider, out sbyte result);

static member TryParse : string * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功分析 s，则 true;否则，false。

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功分析 utf8Text，则 true;否则，false。

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::SByte % result);

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out sbyte result);

static member TryParse : ReadOnlySpan<byte> * sbyte -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As SByte) As Boolean

参数

返回

如果已成功转换 utf8Text，则 true;否则，false。

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result);

public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);

[System.CLSCompliant(false)]
public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out sbyte result);

[System.CLSCompliant(false)]
public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功转换 s，则 true;否则，false。

属性

CLSCompliantAttribute

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

Source:

SByte.cs

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result);

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;

[System.CLSCompliant(false)]
public static bool TryParse(string s, System.Globalization.NumberStyles style, IFormatProvider provider, out sbyte result);

public static bool TryParse(string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);

[System.CLSCompliant(false)]
public static bool TryParse(string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out sbyte result);

[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * sbyte -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As SByte) As Boolean

参数

返回

如果已成功转换 s，则 true;否则，false。

属性

CLSCompliantAttribute

例外

示例

以下示例使用多个不同的字符串和 NumberStyles 值调用 TryParse(String, NumberStyles, IFormatProvider, SByte) 方法。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-106";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "103.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "12E-01";
      CallTryParse(numericString, styles);
          
      numericString = "12E01";
      CallTryParse(numericString, styles); 
      
      numericString = "C8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      sbyte number;
      bool result = SByte.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
      else
         Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
   }
}
// The example displays the following output:
//       Converted '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.

open System
open System.Globalization

let callTryParse (stringToConvert: string) styles =
    match SByte.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."

[<EntryPoint>]
let main _ =
    let numericString = "106"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-106"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "103.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles
    
    let numericString = "103.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "10E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles 
    
    let numericString = "12E-01"
    callTryParse numericString styles
        
    let numericString = "12E01"
    callTryParse numericString styles 
    
    let numericString = "C8"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8C"
    callTryParse numericString NumberStyles.HexNumber
    0

// The example displays the following output:
//       Converted '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.

Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-106"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "103.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "10E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "12E-01"
      CallTryParse(numericString, styles)
          
      numericString = "12E01"
      CallTryParse(numericString, styles) 
      
      numericString = "C8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As SByte
      Dim result As Boolean = SByte.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 '106' to 106.
'       Attempted conversion of '-106' failed.
'       Converted '103.00' to 103.
'       Attempted conversion of '103.72' failed.
'       Converted '10E-01' to 1.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E01' to 120.
'       Converted 'C8' to -56.
'       Attempted conversion of '0x8C' failed.

注解

TryParse(String, NumberStyles, IFormatProvider, SByte) 方法类似于 Parse(String, NumberStyles, IFormatProvider) 方法，只是转换失败时不会引发异常。 如果 value 无效且无法成功分析，则此方法无需使用异常处理来测试 FormatException。

style 参数定义允许 value 参数中允许的样式元素（如空格或正号或负号），以便分析操作成功。 它必须是 NumberStyles 枚举中的位标志的组合。 根据 style的值，value 参数可能包括以下元素：

[ws][$][符号][数字，]位[.fractional_digits][E[符号]exponential_digits][ws]

如果 style 参数包括 AllowHexSpecifier，value 参数可能包含以下元素：

[ws]hexdigits[ws]

方括号 （[ 和 ]） 中的元素是可选的。 下表描述了每个元素。

元素	描述
ws	可选空格。 如果 style 包含 NumberStyles.AllowLeadingWhite 标志，或 value 末尾（如果 style 包含 NumberStyles.AllowTrailingWhite 标志，则空格可能会出现在 value 的开头。
$	区域性特定的货币符号。 字符串中的位置由 provider 参数的 GetFormat 方法返回的 NumberFormatInfo 对象的 CurrencyPositivePattern 属性定义。 如果 style 包含 NumberStyles.AllowCurrencySymbol 标志，货币符号可以出现在 value 中。
签名	可选符号。 如果 style 包含 NumberStyles.AllowLeadingSign 标志，则符号可以在 value 开始时显示，如果 style 包含 NumberStyles.AllowTrailingSign 标志，则它将显示在 value 末尾。 如果 style 包含 NumberStyles.AllowParentheses 标志，则可以在 value 中使用括号来指示负值。
位	从 0 到 9 的数字序列。
、	区域性特定的组分隔符。 如果 style 包含 NumberStyles.AllowThousands 标志，则由 provider 指定的区域性的组分隔符可以显示在 value 中。
。	区域性特定的小数点符号。 如果 style 包含 NumberStyles.AllowDecimalPoint 标志，则由 provider 指定的区域性的小数点符号可以出现在 value 中。
fractional_digits	数字 0 的一个或多个匹配项。 仅当 style 包含 NumberStyles.AllowDecimalPoint 标志时，小数位数才会显示在 value 中。
E	“e”或“E”字符，指示该值以指数（科学）表示法表示。 如果 style 包含 NumberStyles.AllowExponent 标志，value 参数可以表示指数表示法中的数字。
exponential_digits	从 0 到 9 的数字序列。 如果 style 包含 NumberStyles.AllowExponent 标志，value 参数可以表示指数表示法中的数字。
hexdigits	从 0 到 f 或 0 到 F 的十六进制数字序列。

仅包含十进制数字（对应于 NumberStyles.None 标志）的字符串始终成功分析。 其余大部分 NumberStyles 成员控制可能存在的元素，但不需要存在于此输入字符串中。 下表指示单个 NumberStyles 成员如何影响 value中可能存在的元素。

非复合 NumberStyles 值	除数字外，值允许的元素
None	仅十进制数字。
AllowDecimalPoint	小数点（.）和 fractional_digits 元素。 但是，fractional_digits 必须仅包含一个或多个数字，或者该方法返回 false。
AllowExponent	指示指数表示法的“e”或“E”字符以及 exponential_digits。 如果 value 表示指数表示法中的数字，则它不能具有非零的小数分量。
AllowLeadingWhite	value开头的 ws 元素。
AllowTrailingWhite	value末尾的 ws 元素。
AllowLeadingSign	符号 元素，然后 数字。
AllowTrailingSign	位后，符号 元素。
AllowParentheses	符号 元素，以括住数值的括号形式。
AllowThousands	组分隔符（，）元素。
AllowCurrencySymbol	货币 （$） 元素。
Currency	所有元素。 但是，value 不能表示十六进制数或指数表示法中的数字。
Float	ws 元素位于 value开头或末尾，符号value开头，以及小数点（.）符号。 value 参数也可以使用指数表示法。
Number	ws、符号、组分隔符（、）和小数点（.）元素。
Any	所有元素。 但是，value 不能表示十六进制数。

如果使用 NumberStyles.AllowHexSpecifier 标志，value 必须是十六进制值。 有效的十六进制数字为 0-9、a-f 和 A-F。 style 中唯一可以存在的其他标志是 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。 （NumberStyles 枚举具有包含两个空格标志的复合样式 HexNumber。

provider 参数是 IFormatProvider 实现。 其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关 value格式的区域性特定信息。 provider 参数可以是以下任一参数：

• 一个 CultureInfo 对象，该对象表示提供格式设置信息的区域性。 其 GetFormat 方法返回为该区域性提供数值格式信息的 NumberFormatInfo 对象。

• 提供数字格式信息的 NumberFormatInfo 对象。 （它的 GetFormat 实现只是返回自己。

• 实现 IFormatProvider的自定义对象。 其 GetFormat 方法实例化并返回提供格式信息的 NumberFormatInfo 对象。

如果 providernull，则使用当前区域性的 NumberFormatInfo 对象。

另请参阅

• Parse(String, NumberStyles, IFormatProvider)
• 分析 .NET 中的数值字符串