UInt64.TryParse メソッド

定義

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

オーバーロード

TryParse(String, UInt64)

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

TryParse(ReadOnlySpan<Char>, UInt64)

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

TryParse(String, NumberStyles, IFormatProvider, UInt64)

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

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

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

TryParse(String, UInt64)

重要

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

CLS 準拠の代替
System.Decimal.Parse(String)

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

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

パラメーター

s
String

変換する数値を表す文字列。A string that represents the number to convert.

result
UInt64

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

戻り値

Boolean

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

属性

次の例では、 TryParse(String, UInt64) 文字列配列の各要素に対してメソッドを1回呼び出します。The following example calls the TryParse(String, UInt64) method once for each element in a string array.

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

注釈

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

パラメーターは、 s 次の形式の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
jax-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.

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. で使用できるカルチャ固有の書式情報を使用してスタイル要素を明示的に定義するには s 、メソッドを呼び出し TryParse(String, NumberStyles, IFormatProvider, UInt64) ます。To explicitly define the style elements with the culture-specific formatting information that can be present in s, call the TryParse(String, NumberStyles, IFormatProvider, UInt64) method.

注意

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

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

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

こちらもご覧ください

適用対象

製品 Introduced

TryParse(ReadOnlySpan<Char>, UInt64)

重要

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

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

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

パラメーター

s
ReadOnlySpan<Char>

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

result
UInt64

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

戻り値

Boolean

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

属性

適用対象

製品 Introduced

TryParse(String, NumberStyles, IFormatProvider, UInt64)

重要

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

CLS 準拠の代替
System.Decimal.Parse(String)

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

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) 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. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

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

result
UInt64

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

戻り値

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, UInt64) さまざまな文字列と値を指定してメソッドを呼び出し NumberStyles ます。The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt64) method with a number of different strings and NumberStyles values.

using System;
using System.Globalization;

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

      numericString = "41792210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC86DA1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ulong number;
      bool result = UInt64.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output:
//       Converted '2106034' to 2106034.
//       Attempted conversion of '-10603' failed.
//       Converted '29103674.00' to 29103674.
//       Attempted conversion of '10345.72' failed.
//       Converted '41792210E-01' to 4179221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC86DA1' to 4291325345.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

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

      numericString = "41792210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC86DA1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As ULong
      Dim result As Boolean = UInt64.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '2106034' to 2106034.
'       Attempted conversion of '-10603' failed.
'       Converted '29103674.00' to 29103674.
'       Attempted conversion of '10345.72' failed.
'       Converted '41792210E-01' to 4179221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC86DA1' to 4291325345.
'       Attempted conversion of '0x8F8C' failed.

注釈

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

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

[ws][ $ ] [sign] [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 NumberStyles.AllowHexSpecifier パラメーターには次の s 要素を含めることができます。Or, if the style parameter includes NumberStyles.AllowHexSpecifier, the s parameter may include the following elements:

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

次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
jax-wsws 省略可能な空白。Optional white space. がフラグを含む場合、の先頭に空白が表示されます。または、の末尾にフラグが含まれている場合も s style NumberStyles.AllowLeadingWhite s style NumberStyles.AllowTrailingWhite あります。White space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. 文字列内での位置は、 CurrencyPositivePattern NumberFormatInfo パラメーターのメソッドによって返されるオブジェクトのプロパティによって定義され GetFormat provider ます。Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. s フラグが含まれている場合は、通貨記号がに表示され style NumberStyles.AllowCurrencySymbol ます。The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な符号。An optional sign. がフラグを含む場合は、の先頭に符号が表示され s style NumberStyles.AllowLeadingSign ます。また、にフラグが含まれている場合は、の末尾に s style も表示されます NumberStyles.AllowTrailingSignThe sign can appear at the start of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. s フラグが含まれている場合は、かっこを使用して負の値を示すことができ style NumberStyles.AllowParentheses ます。Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. ただし、負の符号が指定されている場合、 s は解析操作が成功するまでの値0のみを表すことができます。However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.
数値digits 0から9までの一連の数字。A sequence of digits from 0 through 9.
,, カルチャ固有のグループ区切り記号。A culture-specific group separator. で指定されたカルチャの区切り記号は、 provider にフラグが含まれている場合は、に表示されます s style NumberStyles.AllowThousandsThe group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. で指定されたカルチャの小数点の記号は、 provider にフラグが含まれている場合にで使用でき s style NumberStyles.AllowDecimalPoint ます。The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 数字0の1回以上の出現。One or more occurrences of the digit 0. にフラグが含まれている場合にのみ、に小数点以下の桁数が表示され s style NumberStyles.AllowDecimalPoint ます。Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
EE "E" または "E" 文字。値が指数 (科学的) 表記で表されることを示します。The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. s フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
exponential_digitsexponential_digits 0から9までの一連の数字。A sequence of digits from 0 through 9. s フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0から f、または0から F までの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 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 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. s 指数表記の数値を表す場合、0以外の小数部分を持つことはできません。If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite の先頭にある ws 要素 sThe ws element at the start of s.
AllowTrailingWhite の末尾の ws 要素 sThe ws element at the end of s.
AllowLeadingSign 数字の前にあるsign要素。The sign element before digits.
AllowTrailingSign 数字の後の符号要素。The sign element after digits.
AllowParentheses 0の数値を囲むかっこ形式の sign 要素。The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands 桁区切り記号 (,) 要素。The group separator (,) element.
AllowCurrencySymbol Currency ( $ ) 要素。The currency ($) element.
Currency すべての要素。All elements. ただし、は、 s 16 進数または指数表記の数値を表すことはできません。However, s cannot represent a hexadecimal number or a number in exponential notation.
Float の先頭または末尾にある ws 要素、 s の先頭に 符号s 小数点 (.) 記号。The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. パラメーターでは、 s 指数表記を使用することもできます。The s parameter can also use exponential notation.
Number Wssign、group separator (,)、および小数点 (.) の各要素。The ws, sign, group separator (,), and decimal point (.) elements.
Any すべての要素。All elements. ただし、は s 16 進数を表すことはできません。However, s cannot represent a hexadecimal number.

NumberStyles.AllowHexSpecifierフラグが使用されている場合、は s 16 進数の値である必要があります。If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. 有効な16進文字は、0-9、A-F、a-f です。Valid hexadecimal characters are 0-9, A-F, and a-f. "0x" のようなプレフィックスはサポートされていないため、解析操作は失敗します。A prefix such as "0x" is not supported and causes the parse operation to fail. 内に存在できるフラグは、とだけ 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.)

注意

sが16進数の文字列形式の場合、 0x &h 16 進数と区別する装飾 (やなど) を前に付けることはできません。If s is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. これにより、変換は失敗します。This causes the conversion to fail.

providerパラメーターは、の IFormatProvider 実装です。The provider parameter is an IFormatProvider implementation. この GetFormat メソッドは、 NumberFormatInfo の書式に関するカルチャ固有の情報を提供するオブジェクトを返し s ます。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. パラメーターには、 provider 次のいずれかを指定できます。The provider parameter can be any one of the following:

  • CultureInfo書式設定情報を提供するカルチャを表すオブジェクト。A CultureInfo object that represents the culture that supplies formatting information. その GetFormat メソッドは、 NumberFormatInfo そのカルチャに対して数値の書式設定情報を提供するオブジェクトを返します。Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • NumberFormatInfo数値の書式設定情報を提供するオブジェクト。A NumberFormatInfo object that provides numeric formatting information. (の実装では、 GetFormat だけが返されます)。(Its implementation of GetFormat just returns itself.)

  • を実装するカスタムオブジェクト 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.

こちらもご覧ください

適用対象

製品 Introduced

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

重要

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

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

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) 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. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

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

result
UInt64

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

戻り値

Boolean

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

属性

適用対象

製品 Introduced