UInt32.TryParse メソッド

定義

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

オーバーロード

TryParse(String, UInt32)

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

TryParse(ReadOnlySpan<Char>, UInt32)

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

TryParse(String, NumberStyles, IFormatProvider, UInt32)

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

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

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

注釈

注意

この記事の C# 例の一部は、Try.NET インライン コード ランナーとプレイグラウンドで実行されます。Some of the C# examples in this article run in the Try.NET inline code runner and playground. [実行] ボタンがある場合は、これを選択して対話型ウィンドウで例を実行します。When present, select the Run button to run an example in an interactive window. コードを実行したら、コードを変更し、 [実行] をもう一度選択して変更後のコードを実行できます。Once you execute the code, you can modify it and run the modified code by selecting Run again. 変更後のコードが対話型ウィンドウで実行されるか、コンパイルできなかった場合、対話型ウィンドウにすべての C# コンパイラ エラー メッセージが表示されます。The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

TryParse(String, UInt32)

重要

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

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

数値の文字列表記を、それと等価の 32 ビット符号なし整数に変換します。Tries to convert the string representation of a number to its 32-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::UInt32 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out uint result);
static member TryParse : string * uint32 -> bool
Public Shared Function TryParse (s As String, ByRef result As UInteger) As Boolean

パラメーター

s
String

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

result
UInt32

このメソッドから制御が返されたとき、変換に成功した場合は、s に格納された数値と等価な 32 ビット符号なし整数値が格納されます。変換に失敗した場合は 0 が格納されます。When this method returns, contains the 32-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 that is 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, UInt32) メソッドを1回呼び出します。The following example calls the TryParse(String, UInt32) method once for each element in a string array.

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

注釈

TryParse メソッドは、変換に失敗した場合に例外をスローしない点を除いて、Parse メソッドに似ています。The TryParse method is like the Parse method, except that it does not throw an exception if the conversion fails. このメソッドを使用すると、s が無効で、正常に解析できない場合に、例外処理を使用して FormatException をテストする必要がなくなります。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]digits[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.

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, UInt32) メソッドを呼び出します。To explicitly define the style elements with the culture-specific formatting information that can be present in s, call the TryParse(String, NumberStyles, IFormatProvider, UInt32) 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 by using the formatting information in a NumberFormatInfo object 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, UInt32) オーバーロードを呼び出します。To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt32) overload instead.

こちらもご覧ください

TryParse(ReadOnlySpan<Char>, UInt32)

重要

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

数値のスパン表現の、それと等価の 32 ビット符号なし整数への変換を試みます。Tries to convert the span representation of a number to its 32-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::UInt32 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out uint result);
static member TryParse : ReadOnlySpan<char> * uint32 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UInteger) As Boolean

パラメーター

s
ReadOnlySpan<Char>

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

result
UInt32

このメソッドから制御が返されたとき、変換に成功した場合は、s に格納された数値と等価な 32 ビット符号なし整数値が格納されます。変換に失敗した場合は 0 が格納されます。When this method returns, contains the 32-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 that is 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, UInt32)

重要

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

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

指定したスタイルおよびカルチャ固有の書式による数値の文字列形式を、それと等価な 32 ビット符号なし整数に変換します。Tries to convert the string representation of a number in a specified style and culture-specific format to its 32-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::UInt32 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out uint result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) 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
UInt32

変換が成功した場合、このメソッドが返されるときに、s に格納された数値と等しい 32 ビット符号なし整数値を格納します。変換に失敗した場合は 0 を格納します。When this method returns, contains the 32-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 that is 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, UInt32) メソッドを呼び出します。The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt32) 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)
   {
      uint number;
      bool result = UInt32.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 UInteger
      Dim result As Boolean = UInt32.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, UInt32) メソッドは、変換に失敗した場合に例外をスローしない点を除いて、Parse(String, NumberStyles, IFormatProvider) メソッドに似ています。The TryParse(String, NumberStyles, IFormatProvider, UInt32) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. このメソッドを使用すると、s が無効で、正常に解析できない場合に、例外処理を使用して FormatException をテストする必要がなくなります。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,]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
wsws 省略可能な空白。Optional white space. styleNumberStyles.AllowLeadingWhite フラグが含まれている場合、また sstyleNumberStyles.AllowTrailingWhite フラグが含まれている場合は、s の先頭に空白が表示されます。White space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. 文字列内の位置は、provider パラメーターの GetFormat メソッドによって返される NumberFormatInfo オブジェクトの CurrencyPositivePattern プロパティによって定義されます。Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. 通貨記号は、styleNumberStyles.AllowCurrencySymbol フラグが含まれている場合に s に表示されます。The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な符号。An optional sign. NumberStyles.AllowLeadingSign フラグが style に含まれている場合、s の先頭に符号が表示されます。また、styleNumberStyles.AllowTrailingSign フラグが含まれている場合は、s の最後に表示されます。The sign can appear at the start of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. NumberStyles.AllowParentheses フラグが style 含まれている場合は、s でかっこを使用して負の値を示すことができます。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 によって指定されたカルチャの区切り記号は、styleNumberStyles.AllowThousands フラグが含まれている場合に s に表示されます。The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. 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.
fractional_digitsfractional_digits 数字0の1回以上の出現。One or more occurrences of the digit 0. 小数点以下の桁数は、styleNumberStyles.AllowDecimalPoint フラグが含まれている場合にのみ s に表示されます。Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
EE "E" または "E" 文字。値が指数 (科学的) 表記で表されることを示します。The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. s パラメーターは、styleNumberStyles.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 パラメーターは、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 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 sの先頭にあるws要素。The ws element at the start of s.
AllowTrailingWhite sの末尾のws要素。The ws element at the end of s.
AllowLeadingSign 数字の前にあるsign要素。The sign element before digits.
AllowTrailingSign 数字の後の符号要素。The sign element after digits.
AllowParentheses 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 sの先頭または末尾にあるws要素、sの先頭に符号、小数点 (.) 記号。The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. s パラメーターでは、指数表記を使用することもできます。The s parameter can also use exponential notation.
Number Wssign、group 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. style に存在できる他のフラグは NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhiteだけです。The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (NumberStyles 列挙体には、2つの空白フラグを含む複合スタイル HexNumberがあります)。(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

注意

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

provider パラメーターは、IFormatProvider の実装です。The provider parameter is an IFormatProvider implementation. GetFormat メソッドは、sの書式に関するカルチャ固有の情報を提供する NumberFormatInfo オブジェクトを返します。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.)

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

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

こちらもご覧ください

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

重要

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

指定したスタイルおよびカルチャ固有の書式による数値のスパン表現の、等価の 32 ビット符号なし整数への変換を試みます。Tries to convert the span representation of a number in a specified style and culture-specific format to its 32-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::UInt32 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out uint result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) 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
UInt32

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

属性

適用対象