UInt64.Parse UInt64.Parse UInt64.Parse UInt64.Parse Method

定義

数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number to its 64-bit unsigned integer equivalent.

オーバーロード

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

指定したスタイルおよびカルチャ固有の書式による数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned integer equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

指定したスタイルの数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified style to its 64-bit unsigned integer equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number to its 64-bit unsigned integer equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

指定したカルチャ固有の書式による数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified culture-specific format to its 64-bit unsigned integer equivalent.

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

重要

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

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

指定したスタイルおよびカルチャ固有の書式による数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned integer equivalent.

public:
 static System::UInt64 Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> uint64
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As ULong

パラメーター

s
String String String 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 NumberStyles NumberStyles 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 IFormatProvider IFormatProvider IFormatProvider

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

戻り値

s で指定した数値と等しい 64 ビット符号なし整数。A 64-bit unsigned integer equivalent to the number specified in s.

例外

s パラメーターが null です。The s parameter is null.

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

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

s パラメーターの形式が style に準拠していません。The s parameter is not in a format compliant with style.

s パラメーターが、MinValue 未満の数値か、MaxValue より大きい数値を表しています。The s parameter represents a number less than MinValue or greater than MaxValue.

または-or- s に 0 以外の小数部の桁が含まれています。s includes non-zero, fractional digits.

次の例では、Parse(String, NumberStyles, IFormatProvider)数値の文字列形式をさまざまなを 64 ビット符号なし整数値に変換します。The following example uses the Parse(String, NumberStyles, IFormatProvider) method to convert various string representations of numbers to 64-bit unsigned integer values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames= { "en-US", "fr-FR" };
      NumberStyles[] styles= { NumberStyles.Integer,
                               NumberStyles.Integer | NumberStyles.AllowDecimalPoint };
      string[] values = { "170209", "+170209.0", "+170209,0", "-103214.00",
                                 "-103214,00", "104561.1", "104561,1" };
      
      // Parse strings using each culture
      foreach (string cultureName in cultureNames)
      {
         CultureInfo ci = new CultureInfo(cultureName);
         Console.WriteLine("Parsing strings using the {0} culture", 
                           ci.DisplayName);
         // Use each style.
         foreach (NumberStyles style in styles)
         {
            Console.WriteLine("   Style: {0}", style.ToString());
            // Parse each numeric string.
            foreach (string value in values)
            {
               try {
                  Console.WriteLine("      Converted '{0}' to {1}.", value,
                                    UInt64.Parse(value, style, ci));
               }
               catch (FormatException) {
                  Console.WriteLine("      Unable to parse '{0}'.", value);
               }      
               catch (OverflowException) {
                  Console.WriteLine("      '{0}' is out of range of the UInt64 type.",
                                    value);
               }
            }
         }
      }                                    
   }
}
// The example displays the following output:
//       Style: Integer
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Unable to parse '+170209,0'.
//          Unable to parse '-103214.00'.
//          Unable to parse '-103214,00'.
//          Unable to parse '104561.1'.
//          Unable to parse '104561,1'.
//       Style: Integer, AllowDecimalPoint
//          Converted '170209' to 170209.
//          Converted '+170209.0' to 170209.
//          Unable to parse '+170209,0'.
//          '-103214.00' is out of range of the UInt64 type.
//          Unable to parse '-103214,00'.
//          '104561.1' is out of range of the UInt64 type.
//          Unable to parse '104561,1'.
//    Parsing strings using the French (France) culture
//       Style: Integer
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Unable to parse '+170209,0'.
//          Unable to parse '-103214.00'.
//          Unable to parse '-103214,00'.
//          Unable to parse '104561.1'.
//          Unable to parse '104561,1'.
//       Style: Integer, AllowDecimalPoint
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Converted '+170209,0' to 170209.
//          Unable to parse '-103214.00'.
//          '-103214,00' is out of range of the UInt64 type.
//          Unable to parse '104561.1'.
//          '104561,1' is out of range of the UInt64 type.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR" }
      Dim styles() As NumberStyles = { NumberStyles.Integer, _
                                       NumberStyles.Integer Or NumberStyles.AllowDecimalPoint }
      Dim values() As String = { "170209", "+170209.0", "+170209,0", "-103214.00", _
                                 "-103214,00", "104561.1", "104561,1" }
      
      ' Parse strings using each culture
      For Each cultureName As String In cultureNames
         Dim ci As New CultureInfo(cultureName)
         Console.WriteLine("Parsing strings using the {0} culture", ci.DisplayName)
         ' Use each style.
         For Each style As NumberStyles In styles
            Console.WriteLine("   Style: {0}", style.ToString())
            ' Parse each numeric string.
            For Each value As String In values
               Try
                  Console.WriteLine("      Converted '{0}' to {1}.", value, _
                                    UInt64.Parse(value, style, ci))
               Catch e As FormatException
                  Console.WriteLine("      Unable to parse '{0}'.", value)   
               Catch e As OverflowException
                  Console.WriteLine("      '{0}' is out of range of the UInt64 type.", _
                                    value)         
               End Try
            Next
         Next
      Next                                    
   End Sub
End Module
' The example displays the following output:
'       Style: Integer
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Unable to parse '+170209,0'.
'          Unable to parse '-103214.00'.
'          Unable to parse '-103214,00'.
'          Unable to parse '104561.1'.
'          Unable to parse '104561,1'.
'       Style: Integer, AllowDecimalPoint
'          Converted '170209' to 170209.
'          Converted '+170209.0' to 170209.
'          Unable to parse '+170209,0'.
'          '-103214.00' is out of range of the UInt64 type.
'          Unable to parse '-103214,00'.
'          '104561.1' is out of range of the UInt64 type.
'          Unable to parse '104561,1'.
'    Parsing strings using the French (France) culture
'       Style: Integer
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Unable to parse '+170209,0'.
'          Unable to parse '-103214.00'.
'          Unable to parse '-103214,00'.
'          Unable to parse '104561.1'.
'          Unable to parse '104561,1'.
'       Style: Integer, AllowDecimalPoint
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Converted '+170209,0' to 170209.
'          Unable to parse '-103214.00'.
'          '-103214,00' is out of range of the UInt64 type.
'          Unable to parse '104561.1'.
'          '104561,1' is out of range of the UInt64 type.

注釈

style (空白、正または負の記号など) で使用できるスタイル要素を定義するパラメーター、s解析操作が成功するためのパラメーター。The style parameter defines the style elements (such as white space or the positive or negative sign symbol) 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.

値に応じてstylesパラメーターは、次の要素を含めることができます。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[.fractional_digits][E[sign]exponential_digits][ws]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 場合styleが含まれていますNumberStyles.AllowHexSpecifiersパラメーターは、次の要素を含めることができます。If style 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. 先頭に空白文字を表示できるs場合styleが含まれています、NumberStyles.AllowLeadingWhiteの最後に、フラグ、およびそれが表示されるs場合styleが含まれています、NumberStyles.AllowTrailingWhiteフラグ。White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear 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 that is 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. (メソッドをスロー、OverflowException場合s負の符号を含み、0 以外の数を表します)。先頭の符号が表示できるs場合styleが含まれています、NumberStyles.AllowLeadingSignフラグの末尾を表示できるs場合styleが含まれています、NumberStyles.AllowTrailingSignフラグ。(The method throws an OverflowException if s includes a negative sign and represents a non-zero number.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear 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.
数字digits 0 ~ 9 桁の数字のシーケンス。A sequence of digits from 0 through 9.
.. カルチャに固有の小数点記号。A culture-specific decimal point symbol. 現在のカルチャの小数点記号に表示されるs場合styleが含まれています、NumberStyles.AllowDecimalPointフラグ。The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 数字 0 ~ 9 の 1 つ以上の出現回数場合styleが含まれています、NumberStyles.AllowExponentフラグ、またはそうでない場合は 0 桁の数字の 1 つ以上の出現回数。One or more occurrences of the digit 0-9 if style includes the NumberStyles.AllowExponent flag, or one or more occurrences of the digit 0 if it does not. 小数部の桁数を表示できる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、または f の 0 から 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 style) 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 使用できる要素s数字だけでなくElements permitted in s in addition to digits
NumberStyles.None 10 進数字のみです。Decimal digits only.
NumberStyles.AllowDecimalPoint 10 進数のポイント (.) とfractional_digits要素。The decimal point (.) and fractional_digits elements. ただし、スタイルが含まれていない場合、NumberStyles.AllowExponentフラグ、 fractional_digitsのみ 1 つまたは複数の 0 の数字で構成する必要があります。 それ以外、OverflowExceptionがスローされます。However, if style does not include the NumberStyles.AllowExponent flag, fractional_digits must consist of only one or more 0 digits; otherwise, an OverflowException is thrown.
NumberStyles.AllowExponent "E"または"E"文字と共に、指数表記を示すexponential_digitsします。The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
NumberStyles.AllowLeadingWhite Wsの先頭にある要素sします。The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Wsの末尾にある要素sします。The ws element at the end of s.
NumberStyles.AllowLeadingSign 前に符号します。A sign before digits.
NumberStyles.AllowTrailingSign 後の符号します。A sign after digits.
NumberStyles.AllowParentheses かっこの前に、と後を負の値を示します。Parentheses before and after digits to indicate a negative value.
NumberStyles.AllowThousands グループ区切り記号 () 要素。The group separator (,) element.
NumberStyles.AllowCurrencySymbol 通貨 ($) 要素。The currency ($) element.

場合、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. "0 x"のようなプレフィックスはサポートされていませんし、解析操作が失敗します。A prefix such as "0x" is not supported and causes the parse operation to fail. のみの他のフラグと組み合わせることができますが、NumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhiteします。The only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (、NumberStyles列挙には、複合数値スタイルが含まれていますNumberStyles.HexNumber、空白文字の両方のフラグが含まれます。)。(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white-space flags.)

注意

場合、sパラメーターは、16 進数の文字列表現、接頭辞が付けることはできません (など0xまたは&h)、16 進数として区別します。If the s parameter 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 parse operation to throw an exception.

providerパラメーターは、IFormatProvider実装がGetFormatメソッドを返します。 をNumberFormatInfoの書式設定に関するカルチャ固有の情報を提供するオブジェクトsします。The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. 3 つの方法を使用する、provider解析操作にカスタムの書式設定情報を指定するパラメーター。There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 実際に渡すことができますNumberFormatInfoの書式情報を提供するオブジェクト。You can pass the actual NumberFormatInfo object that provides formatting information. (その実装のGetFormat単にそれ自体を返します)。(Its implementation of GetFormat simply returns itself.)

  • 渡すことができます、CultureInfo書式を使用するカルチャを指定するオブジェクト。You can pass a CultureInfo object that specifies the culture whose formatting is to be used. そのNumberFormatプロパティは、書式設定情報を提供します。Its NumberFormat property provides formatting information.

  • カスタムを渡すことができますIFormatProvider実装します。You can pass a custom IFormatProvider implementation. そのGetFormatメソッドはインスタンス化する必要がありますを返す、NumberFormatInfoの書式情報を提供するオブジェクト。Its GetFormat method must instantiate and return the NumberFormatInfo object that provides formatting information.

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

こちらもご覧ください

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

重要

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

[System.CLSCompliant(false)]
public static ulong Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> uint64
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As ULong

パラメーター

戻り値

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

重要

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

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

指定したスタイルの数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified style to its 64-bit unsigned integer equivalent.

public:
 static System::UInt64 Parse(System::String ^ s, System::Globalization::NumberStyles style);
[System.CLSCompliant(false)]
public static ulong Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> uint64
Public Shared Function Parse (s As String, style As NumberStyles) As ULong

パラメーター

s
String String String 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 NumberStyles NumberStyles NumberStyles

s に許可されている書式を指定する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that specifies the permitted format of s. 通常指定する値は、Integer です。A typical value to specify is Integer.

戻り値

s で指定した数値と等しい 64 ビット符号なし整数。A 64-bit unsigned integer equivalent to the number specified in s.

例外

s パラメーターが null です。The s parameter is null.

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

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

s パラメーターの形式が style に準拠していません。The s parameter is not in a format compliant with style.

s パラメーターが、MinValue 未満の数値か、MaxValue より大きい数値を表しています。The s parameter represents a number less than MinValue or greater than MaxValue.

または-or- s に 0 以外の小数部の桁が含まれています。s includes non-zero, fractional digits.

次の例の番号を使用して、文字列の配列内の各要素を解析しようとしました。NumberStyles値。The following example tries to parse each element in a string array by using a number of NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values= { " 214309 ", "1,064,181", "(0)", "10241+", " + 21499 ", 
                         " +21499 ", "122153.00", "1e03ff", "91300.0e-2" };
      NumberStyles whitespace =  NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite;
      NumberStyles[] styles= { NumberStyles.None, whitespace, 
                               NumberStyles.AllowLeadingSign | NumberStyles.AllowTrailingSign | whitespace, 
                               NumberStyles.AllowThousands | NumberStyles.AllowCurrencySymbol, 
                               NumberStyles.AllowExponent | NumberStyles.AllowDecimalPoint };

      // Attempt to convert each number using each style combination.
      foreach (string value in values)
      {
         Console.WriteLine("Attempting to convert '{0}':", value);
         foreach (NumberStyles style in styles)
         {
            try {
               ulong number = UInt64.Parse(value, style);
               Console.WriteLine("   {0}: {1}", style, number);
            }   
            catch (FormatException) {
               Console.WriteLine("   {0}: Bad Format", style);
            }   
            catch (OverflowException)
            {
               Console.WriteLine("   {0}: Overflow", value);         
            }         
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    Attempting to convert ' 214309 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: 214309
//       Integer, AllowTrailingSign: 214309
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '1,064,181':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: 1064181
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '(0)':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '10241+':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 10241
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' + 21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' +21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 21499
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '122153.00':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 122153
//    
//    Attempting to convert '1e03ff':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '91300.0e-2':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 913
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { " 214309 ", "1,064,181", "(0)", "10241+", _
                                 " + 21499 ", " +21499 ", "122153.00", _
                                 "1e03ff", "91300.0e-2" }
      Dim whitespace As NumberStyles =  NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite
      Dim styles() As NumberStyles = { NumberStyles.None, _
                                       whitespace, _
                                       NumberStyles.AllowLeadingSign Or NumberStyles.AllowTrailingSign Or whitespace, _
                                       NumberStyles.AllowThousands Or NumberStyles.AllowCurrencySymbol, _
                                       NumberStyles.AllowExponent Or NumberStyles.AllowDecimalPoint }

      ' Attempt to convert each number using each style combination.
      For Each value As String In values
         Console.WriteLine("Attempting to convert '{0}':", value)
         For Each style As NumberStyles In styles
            Try
               Dim number As ULong = UInt64.Parse(value, style)
               Console.WriteLine("   {0}: {1}", style, number)
            Catch e As FormatException
               Console.WriteLine("   {0}: Bad Format", style)
            Catch e As OverflowException
               Console.WriteLine("   {0}: Overflow", value)         
            End Try         
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Attempting to convert ' 214309 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: 214309
'       Integer, AllowTrailingSign: 214309
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '1,064,181':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: 1064181
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '(0)':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '10241+':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 10241
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' + 21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' +21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 21499
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '122153.00':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 122153
'    
'    Attempting to convert '1e03ff':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '91300.0e-2':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 913

注釈

style (空白、正または負記号、桁区切り記号、小数点記号など) で使用できるスタイル要素を定義するパラメーター、s解析操作が成功するためのパラメーター。The style parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the s parameter for the parse operation to succeed. style ビット フラグの組み合わせを使用する必要があります、NumberStyles列挙体。style must be a combination of bit flags from the NumberStyles enumeration. styleパラメーター オーバー ロードする便利な場合にこのメソッドは、sによって表される数システム (10 進または 16 進数) と 16 進数の値の文字列表現が含まれていますs、実行時にしかわからない場合、またはします。空白を許可しないようにするかで記号sします。The style parameter makes this method overload useful when s contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by s is known only at run time, or when you want to disallow white space or a sign symbol in s.

値に応じてstylesパラメーターは、次の要素を含めることができます。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]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 場合styleが含まれていますNumberStyles.AllowHexSpecifiersパラメーターは、次の要素を含めることができます。If style includes NumberStyles.AllowHexSpecifier, the s parameter may contain the following elements:

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

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

要素Element 説明Description
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, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. によって、文字列内の位置が定義されている、NumberFormatInfo.CurrencyNegativePatternNumberFormatInfo.CurrencyPositivePattern現在のカルチャのプロパティ。Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. 現在のカルチャの通貨記号に表示されるs場合styleが含まれています、NumberStyles.AllowCurrencySymbolフラグ。The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign オプションの符号。An optional sign. 先頭に表示できる符号s場合styleが含まれています、NumberStyles.AllowLeadingSignの最後に、フラグ、およびそれが表示されるs場合styleが含まれています、NumberStyles.AllowTrailingSignフラグ。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. かっこを使用できるs負の値を指定する場合styleが含まれています、NumberStyles.AllowParenthesesフラグ。Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. ただし、負の記号は 0 以外でのみ使用できます。それ以外の場合、スロー、OverflowExceptionします。However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
数字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 group separator symbol. 現在のカルチャの桁区切り記号に表示されるs場合styleが含まれています、NumberStyles.AllowThousandsフラグ。The current culture's group separator can appear in s if style includes the NumberStyles.AllowThousands flag.
.. カルチャに固有の小数点記号。A culture-specific decimal point symbol. 現在のカルチャの小数点記号に表示されるs場合styleが含まれています、NumberStyles.AllowDecimalPointフラグ。The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag. 数字の 0 は、解析操作を成功させるための小数部の桁として表示されます。場合fractional_digits他の任意の数字が含まれています、FormatExceptionがスローされます。Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, a FormatException is thrown.
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.
hexdigitshexdigits 0 ~ f、または f の 0 から 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.

数字のみを含む文字列 (に対応する、NumberStyles.Noneスタイル) 常に正常に解析します。A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. 残りのほとんどNumberStylesメンバーが存在する場合がありますが、入力文字列内に存在する必要はありません、要素を制御します。Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in the input string. 次の表に示す個別NumberStylesメンバー内に存在する要素に影響を与えるsします。The following table indicates how individual NumberStyles members affect the elements that may be present in s.

NumberStyles の値NumberStyles value 使用できる要素s数字だけでなくElements permitted in s in addition to digits
None 要素のみです。The digits element only.
AllowDecimalPoint 小数点 (.) と桁の小数部要素。The decimal point (.) and fractional-digits elements.
AllowExponent "E"または"E"文字と共に、指数表記を示すexponential_digitsします。The "e" or "E" character, which indicates exponential notation, along with exponential_digits.
AllowLeadingWhite Ws要素の開始時sします。The ws element at the start of s.
AllowTrailingWhite Wsの末尾にある要素sします。The ws element at the end of s.
AllowLeadingSign サインオン要素の開始時sします。The sign element at the start of s.
AllowTrailingSign サインオンの末尾にある要素sします。The sign element at the end of s.
AllowParentheses サインオン形式の数値を囲むかっこ内の要素。The sign element in the form of parentheses enclosing the numeric value.
AllowThousands グループ区切り記号 (,) の要素。The group separator (,) element.
AllowCurrencySymbol 通貨 ($) の要素。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、桁区切り記号 ()、および小数点 10 進数 (.) 要素。The ws, sign, group separator (,), and decimal point (.) elements.
Any すべての要素。All elements. ただし、 s 16 進数を表すことはできません。However, s cannot represent a hexadecimal number.

異なり、その他のNumberStyles、許可が必要としない、特定のスタイルの要素の存在、値sNumberStyles.AllowHexSpecifierスタイルの値を意味する個別の数値文字でsとして常に解釈されます16 進数の文字。Unlike the other NumberStyles values, which allow for, but do not require, the presence of particular style elements in s, the NumberStyles.AllowHexSpecifier style value means that the individual numeric characters in s are always interpreted as hexadecimal characters. 有効な 16 進数の文字は 0 ~ 9、A ~ F、a ~ f です。Valid hexadecimal characters are 0-9, A-F, and a-f. "0 x"のようなプレフィックスはサポートされていませんし、解析操作が失敗します。A prefix such as "0x" is not supported and causes the parse operation to fail. のみ他のフラグと組み合わせて使用できますが、styleパラメーターはNumberStyles.AllowLeadingWhiteNumberStyles.AllowTrailingWhiteします。The only other flags that can be combined with the style parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (、NumberStyles列挙には、複合数値スタイルが含まれていますNumberStyles.HexNumber、空白文字の両方のフラグが含まれます。)。(The NumberStyles enumeration includes a composite number style, NumberStyles.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.

sで書式設定情報を使用してパラメーターを解析、NumberFormatInfoオブジェクトを現在のシステム カルチャが初期化されます。The s parameter is parsed by using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. 書式情報を含むが、解析操作で使用されるカルチャを指定するには、呼び出し、Parse(String, NumberStyles, IFormatProvider)オーバー ロードします。To specify the culture whose formatting information is used for the parse operation, call the Parse(String, NumberStyles, IFormatProvider) overload.

こちらもご覧ください

Parse(String) Parse(String) Parse(String) Parse(String)

重要

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

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

数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number to its 64-bit unsigned integer equivalent.

public:
 static System::UInt64 Parse(System::String ^ s);
[System.CLSCompliant(false)]
public static ulong Parse (string s);
static member Parse : string -> uint64
Public Shared Function Parse (s As String) As ULong

パラメーター

s
String String String String

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

戻り値

s に格納されている数値と等しい 64 ビット符号なし整数。A 64-bit unsigned integer equivalent to the number contained in s.

例外

s パラメーターが null です。The s parameter is null.

s パラメーターの形式が正しくありません。The s parameter is not in the correct format.

s パラメーターが、MinValue 未満の数値か、MaxValue より大きい数値を表しています。The s parameter represents a number less than MinValue or greater than MaxValue.

次の例では、Parse文字列値の配列を解析します。The following example uses the Parse method to parse an array of string values.

string[] values = { "+13230", "-0", "1,390,146", "$190,235,421,127",
                    "0xFA1B", "163042", "-10", "14065839182",
                    "16e07", "134985.0", "-12034" };
foreach (string value in values)
{
   try {
      ulong number = UInt64.Parse(value); 
      Console.WriteLine("{0} --> {1}", value, number);
   }
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);   
   }  
}
// The example displays the following output:
//       +13230 --> 13230
//       -0 --> 0
//       1,390,146: Bad Format
//       $190,235,421,127: Bad Format
//       0xFA1B: Bad Format
//       163042 --> 163042
//       -10: Overflow
//       14065839182 --> 14065839182
//       16e07: Bad Format
//       134985.0: Bad Format
//       -12034: Overflow
Dim values() As String = { "+13230", "-0", "1,390,146", "$190,235,421,127", _
                           "0xFA1B", "163042", "-10", "14065839182", _
                           "16e07", "134985.0", "-12034" }
For Each value As String In values
   Try
      Dim number As ULong = UInt64.Parse(value) 
      Console.WriteLine("{0} --> {1}", value, number)
   Catch e As FormatException
      Console.WriteLine("{0}: Bad Format", value)
   Catch e As OverflowException
      Console.WriteLine("{0}: Overflow", value)   
   End Try  
Next
' The example displays the following output:
'       +13230 --> 13230
'       -0 --> 0
'       1,390,146: Bad Format
'       $190,235,421,127: Bad Format
'       0xFA1B: Bad Format
'       163042 --> 163042
'       -10: Overflow
'       14065839182 --> 14065839182
'       16e07: Bad Format
'       134985.0: Bad Format
'       -12034: Overflow

注釈

sパラメーターは、次の形式の数値の文字列形式でなければなりません。The s parameter should be the string representation of a 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.NegativeSignNumberFormatInfo.PositiveSign現在のカルチャのプロパティ。Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture. ただし、負の記号は 0 以外でのみ使用できます。それ以外の場合、スロー、OverflowExceptionします。However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.
数字digits 0 から 9 までの数字のシーケンス。A sequence of digits ranging from 0 to 9. 先頭の 0 は無視されます。Any leading zeros are ignored.

注意

指定された文字列、sパラメーターを使用して解釈されます、NumberStyles.Integerスタイル。The string specified by the s parameter is interpreted by using the NumberStyles.Integer style. 任意のグループ区切り記号または 10 進数の区切り記号を含めることはできず、小数部を持つことはできません。It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

sで書式設定情報を使用してパラメーターを解析、System.Globalization.NumberFormatInfoオブジェクトを現在のシステム カルチャが初期化されます。The s parameter is parsed by using the formatting information in a System.Globalization.NumberFormatInfo object that is initialized for the current system culture. 詳細については、「NumberFormatInfo.CurrentInfo」を参照してください。For more information, see NumberFormatInfo.CurrentInfo. 使用して、特定のカルチャの書式設定情報を使用して文字列を解析する、Parse(String, IFormatProvider)メソッド。To parse a string by using the formatting information of a specific culture, use the Parse(String, IFormatProvider) method.

こちらもご覧ください

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

重要

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

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

指定したカルチャ固有の書式による数値の文字列形式を、それと等価な 64 ビット符号なし整数に変換します。Converts the string representation of a number in a specified culture-specific format to its 64-bit unsigned integer equivalent.

public:
 static System::UInt64 Parse(System::String ^ s, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> uint64
Public Shared Function Parse (s As String, provider As IFormatProvider) As ULong

パラメーター

s
String String String String

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

戻り値

s で指定した数値と等しい 64 ビット符号なし整数。A 64-bit unsigned integer equivalent to the number specified in s.

例外

s パラメーターが null です。The s parameter is null.

s パラメーターが正しいスタイルではありません。The s parameter is not in the correct style.

s パラメーターが、MinValue 未満の数値か、MaxValue より大きい数値を表しています。The s parameter represents a number less than MinValue or greater than MaxValue.

次の例は、ボタンは、Web フォームのイベント ハンドラーをクリックします。The following example is the button click event handler of a Web form. によって返される配列を使用して、HttpRequest.UserLanguagesプロパティをユーザーのロケールを決定します。It uses the array returned by the HttpRequest.UserLanguages property to determine the user's locale. インスタンス化し、CultureInfoそのロケールに対応するオブジェクト。It then instantiates a CultureInfo object that corresponds to that locale. NumberFormatInfoオブジェクトに属するCultureInfoオブジェクトに渡されます、Parse(String, IFormatProvider)にユーザーを変換するメソッドの入力をUInt64値。The NumberFormatInfo object that belongs to that CultureInfo object is then passed to the Parse(String, IFormatProvider) method to convert the user's input to a UInt64 value.

protected void OkToSingle_Click(object sender, EventArgs e)
{
   string locale;
   float number;
   CultureInfo culture; 

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return; 

   // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);
   
   // Convert user input from a string to a number
   try
   {
      number = Single.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToSingle_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToSingle.Click
   Dim locale As String
   Dim culture As CultureInfo
   Dim number As Single

   ' Return if string is empty
   If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub

   ' Get locale of web request to determine possible format of number
   If Request.UserLanguages.Length = 0 Then Exit Sub
   locale = Request.UserLanguages(0)
   If String.IsNullOrEmpty(locale) Then Exit Sub

   ' Instantiate CultureInfo object for the user's locale
   culture = New CultureInfo(locale)

   ' Convert user input from a string to a number
   Try
      number = Single.Parse(Me.inputNumber.Text, culture.NumberFormat)
   Catch ex As FormatException
      Exit Sub
   Catch ex As OverflowException
      Exit Sub
   End Try

   ' Output number to label on web form
   Me.outputNumber.Text = "Number is " & number.ToString()
End Sub

注釈

このオーバー ロード、Parse(String, IFormatProvider)メソッドでは、さまざまな方法で書式に設定するテキストに変換するために使用は通常、UInt64値。This overload of the Parse(String, IFormatProvider) method is typically used to convert text that can be formatted in a variety of ways to a UInt64 value. たとえば、これを数値には、HTML テキスト ボックスに、ユーザーが入力したテキストに変換する使用できます。For example, it can be used to convert the text entered by a user into an HTML text box to a numeric value.

sパラメーターには、フォームの番号が含まれています。The s parameter contains a number of the form:

[ws][サインイン] の数字 [ws][ws][sign]digits[ws]

角かっこ ([と]) は任意の項目です。Items in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 空白文字の省略可能です。Optional white space.
signsign 省略可能な正の符号または負の符号場合s値 0 を表します。An optional positive sign, or a negative sign if s represents the value zero.
数字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 unsigned integer value's decimal digits, only leading and trailing spaces along with a leading sign is allowed. (負の符号が存在する場合はs0、またはメソッドでのスローの値を表す必要があります、 OverflowException)。使用できるカルチャに固有の書式情報とスタイル要素を明示的に定義するsを使用して、Parse(String, NumberStyles, IFormatProvider)メソッド。(If the negative sign is present, s must represent a value of zero, or the method throws an OverflowException.) To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Parse(String, NumberStyles, IFormatProvider) method.

providerパラメーターは、IFormatProvider実装がGetFormatメソッドを返します。 をNumberFormatInfoの書式設定に関するカルチャ固有の情報を提供するオブジェクトsします。The provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. 3 つの方法を使用する、provider解析操作にカスタムの書式設定情報を指定するパラメーター。There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • 実際に渡すことができますNumberFormatInfoの書式情報を提供するオブジェクト。You can pass the actual NumberFormatInfo object that provides formatting information. (その実装のGetFormat単にそれ自体を返します)。(Its implementation of GetFormat simply returns itself.)

  • 渡すことができます、CultureInfo書式を使用するカルチャを指定するオブジェクト。You can pass a CultureInfo object that specifies the culture whose formatting is to be used. そのNumberFormatプロパティは、書式設定情報を提供します。Its NumberFormat property provides formatting information.

  • カスタムを渡すことができますIFormatProvider実装します。You can pass a custom IFormatProvider implementation. そのGetFormatメソッドはインスタンス化する必要がありますを返す、NumberFormatInfoの書式情報を提供するオブジェクト。Its GetFormat method must instantiate and return the NumberFormatInfo object that provides formatting information.

場合providernullNumberFormatInfo現在のカルチャが使用されます。If provider is null, the NumberFormatInfo for the current culture is used.

こちらもご覧ください

適用対象