SByte.TryParse メソッド

定義

数値の文字列形式を、それと等価な 8 ビット符号付き整数に変換します。Converts the string representation of a number to its 8-bit signed integer equivalent. リターン コードは、変換が成功したか失敗したかを示します。A return code indicates whether the conversion succeeded or failed.

オーバーロード

TryParse(String, SByte)

数値の文字列形式を対応する SByte 表現に変換できるかどうかを試行し、変換に成功したかどうかを示す値を返します。Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, SByte)

数値のスパン表現の、等価の SByte への変換を試み、変換に成功したかどうかを示す値を返します。Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, NumberStyles, IFormatProvider, SByte)

指定されたスタイルおよびカルチャ固有の書式の数値の文字列形式を等価の SByte に変換できるかどうかを試行し、変換に成功したかどうかを示す値を返します。Tries to convert the string representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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

指定されたスタイルおよびカルチャ固有の書式の数値のスパン表現の、等価の SByte への変換を試み、変換に成功したかどうかを示す値を返します。Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, SByte)

重要

この API は CLS 準拠ではありません。

数値の文字列形式を対応する SByte 表現に変換できるかどうかを試行し、変換に成功したかどうかを示す値を返します。Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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
String

変換する数値を含んだ文字列。A string that contains a number to convert.

result
SByte

このメソッドから制御が返されたとき、変換に成功した場合は、s に格納された数値と等価な 8 ビット符号付き整数値が格納されます。変換に失敗した場合は 0 が格納されます。When this method returns, contains the 8-bit signed 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 in the correct format, or represents a number that is less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

Boolean

s が正常に変換された場合は true。それ以外の場合は falsetrue if s was converted successfully; otherwise, false.

属性

次の例では、メソッドを呼び出して、配列内の文字列を値に変換しようとし SByteTryParse(String, SByte) います。The following example tries to convert the strings in an array to SByte values by calling the TryParse(String, SByte) method.

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.
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) 変換に失敗した場合に例外をスローしない点が異なります。The SByte.TryParse(String, SByte) method is like the SByte.Parse(String) method, except that it does not throw an exception if the conversion fails. このメソッドを使用する FormatException value と、が無効で、正常に解析できない場合に、例外処理を使用してをテストする必要がなくなります。This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be successfully parsed.

パラメーターは、 s 次の形式の10進数の文字列形式である必要があります。The s parameter should be the string representation of a decimal number in the following form:

[ws][sign]数字[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.
数値digits 0 ~ 9 の範囲の10進数のシーケンス。A sequence of decimal digits ranging from 0 to 9.

注意

パラメーターで指定された文字列に、 value グループ区切り記号や小数点を含めることはできません。また、小数点は使用できません。The string specified by the value parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

sパラメーターは、スタイルを使用して解釈され NumberStyles.Integer ます。The s parameter is interpreted by using the NumberStyles.Integer style. 10進数の数字に加えて、先頭と末尾のスペースのみが許可されます。In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. で使用できるカルチャ固有の書式情報を使用してスタイル要素を明示的に定義するには value 、メソッドを呼び出し TryParse(String, NumberStyles, IFormatProvider, SByte) ます。To explicitly define the style elements with the culture-specific formatting information that can be present in value, call the TryParse(String, NumberStyles, IFormatProvider, SByte) method.

sパラメーターは、現在のカルチャのオブジェクトの書式情報を使用して解析され NumberFormatInfo ます。The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current culture. 詳細については、「NumberFormatInfo.CurrentInfo」を参照してください。For more information, see NumberFormatInfo.CurrentInfo.

このオーバーロードは、パラメーター内のすべての桁 value を10進数として解釈します。This overload interprets all digits in the value parameter as decimal digits. 16進数の文字列形式を解析するには、 TryParse(String, NumberStyles, IFormatProvider, SByte) 代わりにオーバーロードを呼び出します。To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, SByte) overload instead.

適用対象

TryParse(ReadOnlySpan<Char>, SByte)

重要

この API は CLS 準拠ではありません。

数値のスパン表現の、等価の SByte への変換を試み、変換に成功したかどうかを示す値を返します。Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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
ReadOnlySpan<Char>

変換する数値を表す文字を格納しているスパン。A span containing the characters representing the number to convert.

result
SByte

このメソッドから制御が返されたとき、変換に成功した場合は、s に格納された数値と等価な 8 ビット符号付き整数値が格納されます。変換に失敗した場合は 0 が格納されます。When this method returns, contains the 8-bit signed 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 in the correct format, or represents a number that is less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

Boolean

s が正常に変換された場合は true。それ以外の場合は falsetrue if s was converted successfully; otherwise, false.

属性

適用対象

TryParse(String, NumberStyles, IFormatProvider, SByte)

重要

この API は CLS 準拠ではありません。

CLS 準拠の代替
System.Int16.TryParse(String, Int16)

指定されたスタイルおよびカルチャ固有の書式の数値の文字列形式を等価の SByte に変換できるかどうかを試行し、変換に成功したかどうかを示す値を返します。Tries to convert the string representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result);
[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
String

変換する数値を表す文字列。A string representing a number to convert.

style
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

s に関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information about s.

result
SByte

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 8 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 8-bit signed 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.

戻り値

Boolean

s が正常に変換された場合は true。それ以外の場合は falsetrue if s was converted successfully; otherwise, false.

属性

例外

styleNumberStyles 値ではありません。style is not a NumberStyles value.

- または --or- styleAllowHexSpecifier 値と HexNumber 値の組み合わせではありません。style is not a combination of AllowHexSpecifier and HexNumber values.

次の例では、 TryParse(String, NumberStyles, IFormatProvider, SByte) さまざまな文字列と値を指定してメソッドを呼び出し NumberStyles ます。The following example calls the TryParse(String, NumberStyles, IFormatProvider, SByte) method with a number of different string and NumberStyles values.

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 '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// 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) 変換に失敗した場合に例外をスローしない点が異なります。The TryParse(String, NumberStyles, IFormatProvider, SByte) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. このメソッドを使用する FormatException value と、が無効で、正常に解析できない場合に、例外処理を使用してをテストする必要がなくなります。This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be parsed successfully.

パラメーターは、 style 解析操作を成功させるためにパラメーターで使用できるスタイル要素 (空白、正または負の符号など) を定義し value ます。The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the value parameter for the parse operation to succeed. 列挙体のビットフラグの組み合わせである必要があり NumberStyles ます。It must be a combination of bit flags from the NumberStyles enumeration. の値に応じて style 、パラメーターには value 次の要素を含めることができます。Depending on the value of style, the value parameter may include the following elements:

[ws][ $ ] [sign] [digits]数字[。fractional_digits] [E [sign]exponential_digits] [ws][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

パラメーターに style が含まれている場合、 AllowHexSpecifier パラメーターには value 次の要素を含めることができます。If the style parameter includes AllowHexSpecifier, the value parameter may include the following elements:

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

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 省略可能な空白。Optional white space. がフラグを含む場合、の先頭に空白が表示されます。または、の末尾にフラグが含まれている場合も value style NumberStyles.AllowLeadingWhite value style NumberStyles.AllowTrailingWhite あります。White space can appear at the start of value if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of value 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. value フラグが含まれている場合は、通貨記号がに表示され style NumberStyles.AllowCurrencySymbol ます。The currency symbol can appear in value if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な符号。An optional sign. がフラグを含む場合は、の先頭に符号が表示され value style NumberStyles.AllowLeadingSign ます。また、にフラグが含まれている場合は、の末尾に value style も表示されます NumberStyles.AllowTrailingSignThe sign can appear at the start of value if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of value if style includes the NumberStyles.AllowTrailingSign flag. value フラグが含まれている場合は、かっこを使用して負の値を示すことができ style NumberStyles.AllowParentheses ます。Parentheses can be used in value to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
数値digits 0から9までの一連の数字。A sequence of digits from 0 through 9.
,, カルチャ固有のグループ区切り記号。A culture-specific group separator. で指定されたカルチャの区切り記号は、 provider にフラグが含まれている場合は、に表示されます value style NumberStyles.AllowThousandsThe group separator of the culture specified by provider can appear in value if style includes the NumberStyles.AllowThousands flag.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. で指定されたカルチャの小数点の記号は、 provider にフラグが含まれている場合にで使用でき value style NumberStyles.AllowDecimalPoint ます。The decimal point symbol of the culture specified by provider can appear in value if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 数字0の1回以上の出現。One or more occurrences of the digit 0. にフラグが含まれている場合にのみ、に小数点以下の桁数が表示され value style NumberStyles.AllowDecimalPoint ます。Fractional digits can appear in value 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. value フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The value 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. value フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The value parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0から f、または0から F までの16進数のシーケンス。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.

10進数の数字のみを含む文字列 (フラグに対応) は、 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 value います。The following table indicates how individual NumberStyles members affect the elements that may be present in value.

非複合 NumberStylesNon-composite NumberStyles values 数字に加えて許容される要素Elements permitted in value in addition to digits
None 10進数のみ。Decimal digits only.
AllowDecimalPoint 小数点 (.) と fractional_digits 要素。The decimal point (.) and fractional_digits elements. ただし、 fractional_digits は1桁以上の0桁で構成されている必要があります。それ以外の場合、メソッドはを返し false ます。However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Exponential_digits と共に指数表記を示す "e" または "e" 文字。The "e" or "E" character, which indicates exponential notation, along with exponential_digits. value 指数表記の数値を表す場合、0以外の小数部分を持つことはできません。If value represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite の先頭にある ws 要素 valueThe ws element at the start of value.
AllowTrailingWhite の末尾の ws 要素 valueThe ws element at the end of value.
AllowLeadingSign 数字 の前にある sign 要素。The sign element before digits.
AllowTrailingSign 数字 の後の 符号 要素。The sign element after digits.
AllowParentheses 数値を囲むかっこ形式の sign 要素。The sign element in the form of parentheses enclosing the numeric value.
AllowThousands 桁区切り記号 (,) 要素。The group separator (,) element.
AllowCurrencySymbol Currency ( $ ) 要素。The currency ($) element.
Currency すべての要素。All elements. ただし、は、 value 16 進数または指数表記の数値を表すことはできません。However, value cannot represent a hexadecimal number or a number in exponential notation.
Float の先頭または末尾にある ws 要素、 value の先頭に 符号value 小数点 (.) 記号。The ws element at the start or end of value, sign at the start of value, and the decimal point (.) symbol. パラメーターでは、 value 指数表記を使用することもできます。The value parameter can also use exponential notation.
Number Wssign、group separator (,)、および小数点 (.) の各要素。The ws, sign, group separator (,), and decimal point (.) elements.
Any すべての要素。All elements. ただし、は value 16 進数を表すことはできません。However, value cannot represent a hexadecimal number.

NumberStyles.AllowHexSpecifierフラグが使用されている場合、は value 16 進数の値である必要があります。If the NumberStyles.AllowHexSpecifier flag is used, value must be a hexadecimal value. 有効な16進数字は、0-9、a-f、A-F です。Valid hexadecimal digits are 0-9, a-f, and A-F. 内に存在できるフラグは、とだけ style です NumberStyles.AllowLeadingWhite NumberStyles.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.)

注意

valueが16進数の文字列形式の場合、 0x &h 16 進数と区別する装飾 (やなど) を前に付けることはできません。If value 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 の書式に関するカルチャ固有の情報を提供するオブジェクトを返し value ます。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of value. パラメーターには、 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.)

  • を実装するカスタムオブジェクト IFormatProviderA custom object that implements IFormatProvider. この GetFormat メソッドは、 NumberFormatInfo 書式設定情報を提供するオブジェクトをインスタンス化して返します。Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

がの場合は provider nullNumberFormatInfo 現在のカルチャのオブジェクトが使用されます。If provider is null, the NumberFormatInfo object for the current culture is used.

こちらもご覧ください

適用対象

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

重要

この API は CLS 準拠ではありません。

指定されたスタイルおよびカルチャ固有の書式の数値のスパン表現の、等価の SByte への変換を試み、変換に成功したかどうかを示す値を返します。Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

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
ReadOnlySpan<Char>

変換する数値を表す文字を格納しているスパン。A span containing the characters that represent the number to convert.

style
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

s に関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information about s.

result
SByte

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 8 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 8-bit signed 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.

戻り値

Boolean

s が正常に変換された場合は true。それ以外の場合は falsetrue if s was converted successfully; otherwise, false.

属性

適用対象