Int64.TryParse メソッド

定義

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

オーバーロード

TryParse(String, Int64)

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

TryParse(ReadOnlySpan<Char>, Int64)

数値のスパン表現を、等価の 64 ビット符号付き整数に変換します。Converts the span representation of a number to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, Int64)

指定したスタイルおよびカルチャに固有の書式による数値の文字列形式を、それと等価の 64 ビット符号付き整数に変換します。Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

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

指定したスタイルおよびカルチャに固有の書式による数値のスパン表現を、等価の 64 ビット符号付き整数に変換します。Converts the span representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

TryParse(String, Int64)

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

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

パラメーター

s
String

変換する数値を含む文字列。A string containing a number to convert.

result
Int64

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 64 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. s パラメーターが null または Empty であるか、正しい形式ではない、または MinValue より小さいか MaxValue より大きい数値を表している場合、変換は失敗します。The conversion fails if the s parameter is null or Empty, is not of the correct format, or represents a number less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

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

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

using System;

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

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

この例では、TryParse(String, Int64) メソッドによって変換できない文字列の一部を次に示します。Some of the strings that the TryParse(String, Int64) method is unable to convert in this example are:

  • "9432.0"."9432.0". 文字列に小数点の区切り文字を含めることができないため、変換に失敗します。整数の数字のみが含まれている必要があります。The conversion fails because the string cannot contain a decimal separator; it must contain integral digits only.

  • "16,667"."16,667". 文字列にはグループ区切り記号を含めることができないため、変換に失敗します。整数の数字のみが含まれている必要があります。The conversion fails because the string cannot contain group separators; it must contain integral digits only.

  • "(100)"."(100)". 現在のカルチャの NumberFormatInfo.NegativeSignNumberFormatInfo.NumberNegativePattern のプロパティで定義されているもの以外の負の符号を文字列に含めることはできないため、変換は失敗します。The conversion fails because the string cannot contain a negative sign other than the one defined by the current culture's NumberFormatInfo.NegativeSign and NumberFormatInfo.NumberNegativePattern properties.

  • "01FA"。"01FA". 文字列に16進数の数字を含めることができないため、変換に失敗します。10進数のみが含まれている必要があります。The conversion fails because the string cannot contain hexadecimal digits; it must contain decimal digits only.

注釈

TryParse メソッドは、Parse メソッドに似ていますが、変換に失敗した場合に TryParse メソッドが例外をスローしない点が異なります。The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails. これにより、s が無効で、正常に解析できない場合に、例外処理を使用して FormatException をテストする必要がなくなります。It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

s パラメーターには、次の形式の数値が含まれています。The s parameter contains a number of the form:

jax-ws[sign] 数字 [ws][ws][sign]digits[ws]

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

要素Element 説明Description
wsws 省略可能な空白。An optional white space.
signsign 省略可能な符号。An optional sign.
数字digits 0から9までの一連の数字。A sequence of digits ranging from 0 to 9.

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

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

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

こちらもご覧ください

TryParse(ReadOnlySpan<Char>, Int64)

数値のスパン表現を、等価の 64 ビット符号付き整数に変換します。Converts the span representation of a number to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

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

パラメーター

s
ReadOnlySpan<Char>

変換する値を表す文字を含むスパン。A span containing the characters representing the number to convert.

result
Int64

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 64 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. s パラメーターが null または Empty であるか、正しい形式ではない、または MinValue より小さいか MaxValue より大きい数値を表している場合、変換は失敗します。The conversion fails if the s parameter is null or Empty, is not of the correct format, or represents a number less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

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

TryParse(String, NumberStyles, IFormatProvider, Int64)

指定したスタイルおよびカルチャに固有の書式による数値の文字列形式を、それと等価の 64 ビット符号付き整数に変換します。Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

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

パラメーター

s
String

変換する数値を含む文字列。A string containing a number to convert. 文字列は、style で指定されたスタイルを使用して解釈されます。The string is interpreted using the style specified by style.

style
NumberStyles

s で存在する可能性を持つスタイル要素を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the style elements that can be present in s. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

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

result
Int64

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 64 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. s パラメーターが null または Empty であるか、style に準拠した形式ではない、または MinValue より小さいか MaxValue より大きい数値を表している場合、変換は失敗します。The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

true が正常に変換された場合は s。それ以外の場合は 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.

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

using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106779";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.AllowLeadingSign;
      CallTryParse(numericString, styles);
      
      numericString = "301677-";
      CallTryParse(numericString, styles);
      
      styles = styles | NumberStyles.AllowTrailingSign;
      CallTryParse(numericString, styles);
      
      numericString = "$10634";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      styles = NumberStyles.Integer | NumberStyles.AllowCurrencySymbol;
      CallTryParse(numericString, styles);
      
      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);
      
      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
          
      numericString = "12E03";
      CallTryParse(numericString, styles); 
      
      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);      
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      CultureInfo provider;
      
      // If currency symbol is allowed, use en-US culture.
      if ((styles & NumberStyles.AllowCurrencySymbol) > 0)
         provider = new CultureInfo("en-US");
      else
         provider = CultureInfo.InvariantCulture;
            
      bool success = Int64.TryParse(stringToConvert, styles,
                                   provider, out long number);
      if (success)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106779"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.AllowLeadingSign
      CallTryParse(numericString, styles)
      
      numericString = "301677-"
      CallTryParse(numericString, styles)
      
      styles = styles Or NumberStyles.AllowTrailingSign
      CallTryParse(numericString, styles)
      
      numericString = "$10634"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      styles = NumberStyles.Integer Or NumberStyles.AllowCurrencySymbol
      CallTryParse(numericString, styles)

      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Long
      Dim provider As CultureInfo
      
      ' If currency symbol is allowed, use en-US culture.
      If CBool(styles And NumberStyles.AllowCurrencySymbol) Then
         provider = CultureInfo.CurrentCulture
      Else
         provider = New CultureInfo("en-US")
      End If
      
      Dim result As Boolean = Int64.TryParse(stringToConvert, styles, _
                                             provider, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '106779' to 106779.
'       Attempted conversion of '-30677' failed.
'       Converted '-30677' to -30677.
'       Attempted conversion of '301677-' failed.
'       Converted '301677-' to -301677.
'       Attempted conversion of '$10634' failed.
'       Converted '$10634' to 10634.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to 32961.
'       Attempted conversion of '0x80C1' failed.

注釈

TryParse メソッドは、Parse メソッドに似ていますが、変換に失敗した場合に TryParse メソッドが例外をスローしない点が異なります。The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails. これにより、s が無効で、正常に解析できない場合に、例外処理を使用して FormatException をテストする必要がなくなります。It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be parsed successfully.

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

jax-ws[$]シャープ[数字,] 数字 [. fractional_digits] [e [sign] exponential_digits] [ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws]

または、style パラメーターに NumberStyles.AllowHexSpecifierが含まれている場合は、次のようになります。Or, if the style parameter includes NumberStyles.AllowHexSpecifier:

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

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

要素Element 説明Description
wsws 省略可能な空白。Optional white space. NumberStyles.AllowLeadingWhite フラグが style に含まれている場合、また sstyleNumberStyles.AllowTrailingWhite フラグが含まれている場合は、s の先頭に空白が表示されます。White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. 文字列内の位置は、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. 通貨記号は、styleNumberStyles.AllowCurrencySymbol フラグが含まれている場合に s に表示されます。The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な符号。An optional sign. 符号は、styleNumberStyles.AllowLeadingSign または NumberStyles.AllowTrailingSign フラグが含まれている場合に s に表示されます。A sign symbol can appear in s if style includes the NumberStyles.AllowLeadingSign or NumberStyles.AllowTrailingSign flags.
数字digits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
0から9までの一連の数字。A sequence of digits from 0 through 9. Fractional_digitsの場合は、数字0のみが有効です。For fractional_digits, only the digit 0 is valid.
, カルチャ固有の桁区切り記号。A culture-specific thousands separator. provider で指定されたカルチャの桁区切り記号は、styleNumberStyles.AllowThousands フラグが含まれている場合に s に表示されます。The thousands separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. provider によって指定されたカルチャの小数点記号は、styleNumberStyles.AllowDecimalPoint フラグが含まれている場合に s に表示されます。The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
ee "E" または "E" 文字。値が指数表記で表されることを示します。The 'e' or 'E' character, which indicates that the value is represented in exponential notation. s パラメーターは、styleNumberStyles.AllowExponent フラグが含まれている場合に指数表記で数値を表すことができます。The s 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.

注意

s 内の終端の NUL (U + 0000) 文字は、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 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 s in addition to digits
NumberStyles.None 10進数のみ。Decimal digits only.
NumberStyles.AllowDecimalPoint 小数点 ( .The decimal point ( . ) とfractional_digits要素。) 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.
NumberStyles.AllowExponent s パラメーターでは、指数表記を使用することもできます。The s parameter can also use exponential notation. s パラメーターは、0以外の小数部分を含まない、Int64 データ型の範囲内の整数を表す必要があります。The s parameter must represent an integer within the range of the Int64 data type without a non-zero fractional component.
NumberStyles.AllowLeadingWhite sの先頭にあるws要素。The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite sの末尾のws要素。The ws element at the end of s.
NumberStyles.AllowLeadingSign 数字の前に記号を付けることができます。A sign can appear before digits.
NumberStyles.AllowTrailingSign 数字の後に符号が表示されます。A sign can appear after digits.
NumberStyles.AllowParentheses 数値を囲むかっこ形式のsign要素。The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands 桁区切り記号 ( , ) 要素。The thousands separator ( , ) element.
NumberStyles.AllowCurrencySymbol $ 要素。The $ element.
NumberStyles.Currency すべての要素。All elements. s パラメーターは、16進数または指数表記の数値を表すことはできません。The s parameter cannot represent a hexadecimal number or a number in exponential notation.
NumberStyles.Float sの先頭または末尾のws要素、sの先頭にある記号、および小数点 ( .The ws element at the beginning or end of s, sign at the beginning of s, and the decimal point ( . 表す.) symbol. s パラメーターでは、指数表記を使用することもできます。The s parameter can also use exponential notation.
NumberStyles.Number Wssign、桁区切り記号 ()、および小数点 (.) の要素。The ws, sign, thousands separator (,), and decimal point (.) elements.
NumberStyles.Any s を除くすべてのスタイルは、16進数を表すことはできません。All styles, except s cannot represent a hexadecimal number.

NumberStyles.AllowHexSpecifier フラグが使用されている場合、s はプレフィックスのない16進数の値である必要があります。If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. たとえば、"C9AF3" は正常に解析されますが、"0xC9AF3" は正常に解析されません。For example, "C9AF3" parses successfully, but "0xC9AF3" does not. style に存在できる他のフラグは NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhiteだけです。The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (NumberStyles 列挙体には、2つの空白フラグを含む複合スタイル NumberStyles.HexNumberがあります)。(The NumberStyles enumeration has a composite style, NumberStyles.HexNumber, that includes both white space flags.)

provider パラメーターは、CultureInfo オブジェクトや NumberFormatInfo オブジェクトなどの IFormatProvider の実装で、GetFormat メソッドが NumberFormatInfo オブジェクトを返します。The provider parameter is an IFormatProvider implementation, such as a CultureInfo object or a NumberFormatInfo object, whose GetFormat method returns a NumberFormatInfo object. NumberFormatInfo オブジェクトは、sの形式に関するカルチャ固有の情報を提供します。The NumberFormatInfo object provides culture-specific information about the format of s. providernull場合は、現在のカルチャの NumberFormatInfo オブジェクトが使用されます。If provider is null, the NumberFormatInfo object for the current culture is used.

こちらもご覧ください

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

指定したスタイルおよびカルチャに固有の書式による数値のスパン表現を、等価の 64 ビット符号付き整数に変換します。Converts the span representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent. 戻り値は変換が成功したか失敗したかを示します。A return value indicates whether the conversion succeeded or failed.

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

パラメーター

s
ReadOnlySpan<Char>

変換する値を表す文字を含むスパン。A span containing the characters representing the number to convert. このスパンは、style で指定されたスタイルを使用して解釈されます。The span is interpreted using the style specified by style.

style
NumberStyles

s で存在する可能性を持つスタイル要素を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the style elements that can be present in s. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

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

result
Int64

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等価の 64 ビット符号付き整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. s パラメーターが null または Empty であるか、style に準拠した形式ではない、または MinValue より小さいか MaxValue より大きい数値を表している場合、変換は失敗します。The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

戻り値

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

適用対象