BigInteger.Parse 方法

參考

定義

命名空間:: System.Numerics

組件:: System.Runtime.Numerics.dll

組件:: System.Numerics.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將數字的字串表示，轉換為其相等的 BigInteger。

多載

Parse(String)	將數字的字串表示，轉換為其相等的 BigInteger。
Parse(ReadOnlySpan<Char>, IFormatProvider)	將字元範圍剖析為值。
Parse(String, NumberStyles)	將指定樣式中數字的字串表示轉換為其相等的 BigInteger。
Parse(String, IFormatProvider)	將使用指定特定文化特性格式之數字的字串表示轉換為其相等的 BigInteger。
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	將所指定唯讀字元範圍中具有所指定樣式的數字表示法轉換為其 BigInteger 對等項目。
Parse(String, NumberStyles, IFormatProvider)	將數字的字串表示 (使用指定樣式和特定文化特性的格式) 轉換為其相等的 BigInteger。

Parse(String)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將數字的字串表示，轉換為其相等的 BigInteger。

public:
 static System::Numerics::BigInteger Parse(System::String ^ value);

public static System.Numerics.BigInteger Parse (string value);

static member Parse : string -> System.Numerics.BigInteger

Public Shared Function Parse (value As String) As BigInteger

參數

value: String

字串，包含要轉換的數字。

傳回

BigInteger

值，相當於以 value 參數指定的數字。

例外狀況

ArgumentNullException

value 為 null。

FormatException

value 的格式不正確。

範例

下列範例會 Parse(String) 使用方法來具現化兩個 BigInteger 物件。它會將每個物件乘以另一個數位，然後呼叫 Compare 方法來判斷兩個值之間的關聯性。

string stringToParse = String.Empty;
try
{
   // Parse two strings.
   string string1, string2;
   string1 = "12347534159895123";
   string2 = "987654321357159852";
   stringToParse = string1;
   BigInteger number1 = BigInteger.Parse(stringToParse);
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number1);
   stringToParse = string2;
   BigInteger number2 = BigInteger.Parse(stringToParse);
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number2);
   // Perform arithmetic operations on the two numbers.
   number1 *= 3;
   number2 *= 2;
   // Compare the numbers.
   int result = BigInteger.Compare(number1, number2);
   switch (result)
   {
      case -1:
         Console.WriteLine("{0} is greater than {1}.", number2, number1);
         break;
      case 0:
         Console.WriteLine("{0} is equal to {1}.", number1, number2);
         break;
      case 1:
         Console.WriteLine("{0} is greater than {1}.", number1, number2);
         break;
   }
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse {0}.", stringToParse);
}
// The example displays the following output:
//    Converted '12347534159895123' to 12,347,534,159,895,123.
//    Converted '987654321357159852' to 987,654,321,357,159,852.
//    1975308642714319704 is greater than 37042602479685369.

Dim stringToParse As String = String.Empty
Try
   ' Parse two strings.
   Dim string1, string2 As String
   string1 = "12347534159895123"
   string2 = "987654321357159852"
   stringToParse = string1
   Dim number1 As BigInteger = BigInteger.Parse(stringToParse)
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number1)
   stringToParse = string2
   Dim number2 As BigInteger = BigInteger.Parse(stringToParse)
   Console.WriteLine("Converted '{0}' to {1:N0}.", stringToParse, number2)
   ' Perform arithmetic operations on the two numbers.
   number1 *= 3
   number2 *= 2
   ' Compare the numbers.
   Select Case BigInteger.Compare(number1, number2)
      Case -1
         Console.WriteLine("{0} is greater than {1}.", number2, number1)
      Case 0
         Console.WriteLine("{0} is equal to {1}.", number1, number2)
      Case 1
         Console.WriteLine("{0} is greater than {1}.", number1, number2)
   End Select      
Catch e As FormatException
   Console.WriteLine("Unable to parse {0}.", stringToParse)
End Try
' The example displays the following output:
'    Converted '12347534159895123' to 12,347,534,159,895,123.
'    Converted '987654321357159852' to 987,654,321,357,159,852.
'    1975308642714319704 is greater than 37042602479685369.

備註

參數 value 應該是以下列形式表示數位的字串。

[ws][sign]digits[ws]

在方括號 ([ 和 ]) 中的項目是選擇性的項目。下表說明每個元素。

元素	描述
ws	選擇性空格符。
簽署	選擇性符號。有效的符號字元取決於 NumberFormatInfo.NegativeSign 目前文化特性的和 NumberFormatInfo.PositiveSign 屬性。
數字	範圍從 0 到 9 的數位序列。忽略任何前置零。

注意

參數指定的 value 字串會使用 NumberStyles.Integer 樣式來解譯。它不能包含任何群組分隔符或小數分隔符，而且不能有小數部分。

參數 value 會使用針對目前系統文化特性初始化的物件中的 System.Globalization.NumberFormatInfo 格式信息進行剖析。如需詳細資訊，請參閱NumberFormatInfo.CurrentInfo。若要使用特定文化特性的格式資訊剖析字串，請使用 Parse(String, IFormatProvider) 方法。

重要

如果您使用 Parse 方法來回傳回方法所輸出ToString值的字串表示BigInteger法，您應該使用 BigInteger.ToString(String) 方法搭配 “R” 格式規範來產生值的字串表示BigInteger。否則，的 BigInteger 字串表示只會保留原始值的50個最大有效位數，而且當您使用 Parse 方法來還原 BigInteger 值時，可能會遺失數據。

另請參閱

TryParse

適用於

Parse(ReadOnlySpan<Char>, IFormatProvider)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將字元範圍剖析為值。

public:
 static System::Numerics::BigInteger Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<System::Numerics::BigInteger>::Parse;

public static System.Numerics.BigInteger Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> System.Numerics.BigInteger

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As BigInteger

參數

s: ReadOnlySpan<Char>

要剖析的字元範圍。

provider: IFormatProvider

提供關於 s 之特定文化特性格式資訊的物件。

傳回

BigInteger

剖析 s的結果。

實作

Parse(ReadOnlySpan<Char>, IFormatProvider)

適用於

Parse(String, NumberStyles)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將指定樣式中數字的字串表示轉換為其相等的 BigInteger。

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, System::Globalization::NumberStyles style);

public static System.Numerics.BigInteger Parse (string value, System.Globalization.NumberStyles style);

static member Parse : string * System.Globalization.NumberStyles -> System.Numerics.BigInteger

Public Shared Function Parse (value As String, style As NumberStyles) As BigInteger

參數

value: String

字串，其包含要轉換的數字。

style: NumberStyles

指定 value 可以使用的格式之列舉值的位元組合。

傳回

BigInteger

值，相當於以 value 參數指定的數字。

例外狀況

ArgumentException

style 不是 NumberStyles 值。

-或-

style 包含 AllowHexSpecifier 或 HexNumber 旗標和其他值。

ArgumentNullException

value 為 null。

FormatException

value 不符合由 NumberStyles 所指定的輸入模式。

範例

下列範例說明對方法的呼叫 Parse(String, NumberStyles) ，其中具有數個參數的可能值 style 。它說明如何將字串解譯為十六進位值，以及如何禁止空格和符號。

BigInteger number;
// Method should succeed (white space and sign allowed)
number = BigInteger.Parse("   -68054   ", NumberStyles.Integer);
Console.WriteLine(number);
// Method should succeed (string interpreted as hexadecimal)
number = BigInteger.Parse("68054", NumberStyles.AllowHexSpecifier);
Console.WriteLine(number);
// Method call should fail: sign not allowed
try
{
   number = BigInteger.Parse("   -68054  ", NumberStyles.AllowLeadingWhite
                                            | NumberStyles.AllowTrailingWhite);
   Console.WriteLine(number);
}
catch (FormatException e)
{
   Console.WriteLine(e.Message);
}
// Method call should fail: white space not allowed
try
{
   number = BigInteger.Parse("   68054  ", NumberStyles.AllowLeadingSign);
   Console.WriteLine(number);
}
catch (FormatException e)
{
   Console.WriteLine(e.Message);
}
//
// The method produces the following output:
//
//     -68054
//     426068
//     Input string was not in a correct format.
//     Input string was not in a correct format.

Dim number As BigInteger 
' Method should succeed (white space and sign allowed)
number = BigInteger.Parse("   -68054   ", NumberStyles.Integer)
Console.WriteLine(number)
' Method should succeed (string interpreted as hexadecimal)
number = BigInteger.Parse("68054", NumberStyles.AllowHexSpecifier)
Console.WriteLine(number)
' Method call should fail: sign not allowed
Try
   number = BigInteger.Parse("   -68054  ", NumberStyles.AllowLeadingWhite _
                                            Or NumberStyles.AllowTrailingWhite)
   Console.WriteLine(number)
Catch e As FormatException
   Console.WriteLine(e.Message)
End Try                                                     
' Method call should fail: white space not allowed
Try
   number = BigInteger.Parse("   68054  ", NumberStyles.AllowLeadingSign)
   Console.WriteLine(number)
Catch e As FormatException
   Console.WriteLine(e.Message)
End Try    
'
' The method produces the following output:
'
'     -68054
'     426068
'     Input string was not in a correct format.
'     Input string was not in a correct format.

備註

參數 style 會定義樣式專案 (，例如空格符、正負號符號、群組分隔符符號，或參數中 value 允許的小數點符號) ，讓剖析作業成功。 styles 必須是列舉中的 NumberStyles 位旗標組合。當style包含十六進位值的字串表示、數字系統 (十進位或十六進位) value 只在運行時間知道時，或是當您想要不允許空格符或中的value符號時，參數會使這個方法多載很有用value。

根據的值 style， value 參數可能包含下列元素：

[ws][$][sign][digits，]digits[.fractional_digits][E[sign]exponential_digits][ws]

如果 style 包含 NumberStyles.AllowHexSpecifier，則 value 參數可能包含下列元素：

[ws]hexdigits[ws]

在方括號 ([ 和 ]) 中的項目是選擇性的項目。下表說明每個元素。

元素	描述
ws	選擇性空格符。如果包含旗標，則空格元可以出現在 `value` 開頭，如果`style`包含 NumberStyles.AllowTrailingWhite 旗標，則會出現在結尾`value`。NumberStyles.AllowLeadingWhite`style`
$	特定文化特性的貨幣符號。字串中的位置是由 NumberFormatInfo.CurrencyNegativePattern 目前文化特性的和 NumberFormatInfo.CurrencyPositivePattern 屬性所定義。如果`style`包含 NumberStyles.AllowCurrencySymbol 旗標，則目前文化特性的貨幣符號可能會出現在中`value`。
簽署	選擇性符號。如果包含旗標，則符號可以出現在 `value` 開頭，如果包含 NumberStyles.AllowTrailingSign 旗標，則會出現在結尾`stylevalue`。NumberStyles.AllowLeadingSign`style` 如果包含 NumberStyles.AllowParentheses 旗標，則可以在中使用`value`括弧來表示負值`style`。
數字 fractional_digits exponential_digits	從 0 到 9 的數位序列。對於 fractional_digits，只有數位0有效。
,	特定文化特性的群組分隔符符號。如果`style`包含 NumberStyles.AllowThousands 旗標，則目前文化特性的群組分隔符可以出現在中`value`。
.	特定文化特性的小數點符號。如果`style`包含 NumberStyles.AllowDecimalPoint 旗標，則目前的文化特性小數點符號可能會出現在中`value`。只有數位 0 可以顯示為小數位數，剖析作業才會成功;如果 fractional_digits 包含任何其他數位， FormatException 則會擲回。
E	“e” 或 “E” 字元，表示該值是以指數 (科學) 表示法表示。如果`style`包含 NumberStyles.AllowExponent 旗標，參數`value`可以代表指數表示法的數位。
hexdigits	從 0 到 f 或 0 到 F 的十六進位數位序列。

注意

中任何終止的 NUL (U+0000) 字元 s 都會被剖析作業忽略，不論自變數的值 style 為何。

只有數位的字串 (對應至 NumberStyles.None 樣式) 一律會成功剖析。大部分的其餘 NumberStyles 成員控件專案可能存在，但不需要出現在輸入字串中。下表指出個別 NumberStyles 成員如何影響中 value可能存在的專案。

`NumberStyles` 值	除了數位之外允許 `value` 的專案
None	僅限 digits 元素。
AllowDecimalPoint	小數點 (.) 和小數位數元素。
AllowExponent	“e” 或 “E” 字元，表示指數表示法，以及 exponential_digits。
AllowLeadingWhite	開頭的 `value`ws 元素。
AllowTrailingWhite	結尾處的 `value`ws 元素。
AllowLeadingSign	開頭的 `value`sign 元素。
AllowTrailingSign	結尾處的`value`符號專案。
AllowParentheses	以括弧括住數值形式的 sign 元素。
AllowThousands	群組分隔符 (，) 專案。
AllowCurrencySymbol	貨幣 ($) 元素。
Currency	所有元素。不過， `value` 不能代表十六進位數或指數表示法中的數位。
Float	開頭或結尾的 `value`ws 元素，會在開頭加上符號`value`，小數點 (。) 符號。參數 `value` 也可以使用指數表示法。
Number	、、群組分隔符 (、) 和小數點 (。) 元素。 `signws`
Any	所有元素。不過， `value` 不能代表十六進位數。

重要

如果您使用 Parse 方法來回傳方法所輸出ToString值的字串表示BigInteger法，則應該使用 BigInteger.ToString(String) 方法搭配 “R” 格式規範來產生值的字串表示BigInteger。否則，的字串表示 BigInteger 只會保留原始值的50個最大有效位數，而且當您使用 Parse 方法來還原 BigInteger 值時，可能會遺失數據。

不同於允許但不需要的其他 NumberStyles 值，在中 value存在特定樣式元素，樣式 NumberStyles.AllowHexSpecifier 值表示中的 value 個別數值字元一律會解譯為十六進位字元。有效的十六進位字元為0-9、A-F和 a-f。唯一可以與 style 參數結合的其他旗標為 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。 (列舉 NumberStyles 包含複合數字樣式， HexNumber其中包含空格符旗標.)

注意

如果 value 是十六進位數位的字串表示法，則不能在前面加上任何裝飾 (，例如 0x 或 &h) ，將它區分為十六進位數。這會導致轉換失敗。

如果 value 是十六進位字串，Parse(String, NumberStyles)則如果方法的前兩個十六進位數位大於或等於 0x80，則方法會使用兩個補碼表示法來解譯value為負數。換句話說，方法會將中 value 第一個字節的最高順序位解譯為符號位。為了確保十六進位字串正確解譯為正數，中的 value 第一個數字必須有零值。例如，方法會 0x80 解譯為負值，但它會將 0x080 或 0x0080 解譯為正值。下列範例說明十六進位字串之間的差異，這些字串代表負值和正值。

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "80", "E293", "F9A2FF", "FFFFFFFF",
                              "080", "0E293", "0F9A2FF", "0FFFFFFFF",
                              "0080", "00E293", "00F9A2FF", "00FFFFFFFF" };
      foreach (string hexString in hexStrings)
      {
         BigInteger number = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
      }
   }
}
// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim hexStrings() As String = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                                     "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                                     "0080", "00E293", "00F9A2FF", "00FFFFFFFF" }
      For Each hexString As String In hexStrings
         Dim number As BigInteger = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
      Next         
   End Sub
End Module
' The example displays the following output:
'       Converted 0x80 to -128.
'       Converted 0xE293 to -7533.
'       Converted 0xF9A2FF to -417025.
'       Converted 0xFFFFFFFF to -1.
'       Converted 0x080 to 128.
'       Converted 0x0E293 to 58003.
'       Converted 0x0F9A2FF to 16360191.
'       Converted 0x0FFFFFFFF to 4294967295.
'       Converted 0x0080 to 128.
'       Converted 0x00E293 to 58003.
'       Converted 0x00F9A2FF to 16360191.
'       Converted 0x00FFFFFFFF to 4294967295.

參數 value 是使用物件中 NumberFormatInfo 針對目前系統文化特性初始化的格式信息進行剖析。若要指定用於剖析作業的格式資訊的文化特性，請呼叫 Parse(String, NumberStyles, IFormatProvider) 多載。

另請參閱

TryParse

適用於

Parse(String, IFormatProvider)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將使用指定特定文化特性格式之數字的字串表示轉換為其相等的 BigInteger。

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, IFormatProvider ^ provider);

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, IFormatProvider ^ provider) = IParsable<System::Numerics::BigInteger>::Parse;

public static System.Numerics.BigInteger Parse (string value, IFormatProvider provider);

public static System.Numerics.BigInteger Parse (string value, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> System.Numerics.BigInteger

Public Shared Function Parse (value As String, provider As IFormatProvider) As BigInteger

參數

value: String

字串，其包含要轉換的數字。

provider: IFormatProvider

提供關於 value 之特定文化特性格式資訊的物件。

傳回

BigInteger

值，相當於以 value 參數指定的數字。

實作

Parse(String, IFormatProvider)

例外狀況

ArgumentNullException

value 為 null。

FormatException

value 的格式不正確。

範例

下列範例示範兩種方式，將磚 (~) 定義為格式化 BigInteger 值的負號。請注意，若要以與原始字串相同的格式顯示 BigInteger 值，您的程式代碼必須呼叫 BigInteger.ToString(IFormatProvider) 方法，並傳遞 NumberFormatInfo 提供格式信息的物件。

第一個範例會定義實作 IFormatProvider 的類別，並使用 GetFormat 方法來傳回 NumberFormatInfo 提供格式化信息的物件。

public class BigIntegerFormatProvider : IFormatProvider
{
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(NumberFormatInfo))
      {
         NumberFormatInfo numberFormat = new NumberFormatInfo();
         numberFormat.NegativeSign = "~";
         return numberFormat;
      }
      else
      {
         return null;
      }
   }
}

Public Class BigIntegerFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                            Implements IFormatProvider.GetFormat
      If formatType Is GetType(NumberFormatInfo) Then
         Dim numberFormat As New NumberFormatInfo
         numberFormat.NegativeSign = "~"
         Return numberFormat
      Else
         Return Nothing
      End If      
   End Function
End Class

BigInteger然後可以使用下列程式代碼具現化物件：

BigInteger number = BigInteger.Parse("~6354129876", new BigIntegerFormatProvider());
// Display value using same formatting information
Console.WriteLine(number.ToString(new BigIntegerFormatProvider()));
// Display value using formatting of current culture
Console.WriteLine(number);

Dim number As BigInteger = BigInteger.Parse("~6354129876", New BigIntegerFormatProvider)
' Display value using same formatting information
Console.WriteLine(number.ToString(New BigIntegerFormatProvider))
' Display value using formatting of current culture
Console.WriteLine(number)

第二個範例更為簡單。它會將提供格式資訊的對象傳遞 NumberFormatInfo 至 provider 參數。

NumberFormatInfo fmt = new NumberFormatInfo();
fmt.NegativeSign = "~";

BigInteger number = BigInteger.Parse("~6354129876", fmt);
// Display value using same formatting information
Console.WriteLine(number.ToString(fmt));
// Display value using formatting of current culture
Console.WriteLine(number);

Dim fmt As New NumberFormatInfo()
fmt.NegativeSign = "~"

Dim number As BigInteger = BigInteger.Parse("~6354129876", fmt)
' Display value using same formatting information
Console.WriteLine(number.ToString(fmt))
' Display value using formatting of current culture
Console.WriteLine(number)

備註

參數 value 應該是數位的字串表示，格式如下：

[ws][sign]digits[ws]

在方括號 ([ 和 ]) 中的項目是選擇性的項目。下表說明每個元素。

元素	描述
ws	選擇性空格符。
簽署	選擇性符號。有效的符號字元是由 NumberFormatInfo.NegativeSign 物件的方法所`provider`傳回之物件的 GetFormat 和 NumberFormatInfo.PositiveSign 屬性NumberFormatInfo所決定。
數字	介於 0 到 9 的數位序列。忽略任何前置零。

注意

參數指定的 value 字串會使用 NumberStyles.Integer 樣式來解譯。它不能包含任何群組分隔符或小數分隔符，而且不能有小數部分。

重要

參數 provider 是實作 IFormatProvider ，其 GetFormat 方法會 NumberFormatInfo 傳回提供特定文化特性格式信息的物件。 Parse(String, IFormatProvider)叫用方法時，它會呼叫 provider 參數的方法，並傳遞Type代表NumberFormatInfo型別的 GetFormat 物件。 GetFormat然後，方法會NumberFormatInfo傳回物件，提供參數格式value的相關信息。有三種方式可以使用 provider 參數，將自定義格式資訊提供給剖析作業：

您可以傳遞 CultureInfo 物件，此物件代表提供格式化資訊的文化特性。其 GetFormat 方法會傳 NumberFormatInfo 回物件，提供該文化特性的數值格式資訊。
您可以傳遞提供數值格式資訊的實際 NumberFormatInfo 物件。 (其實作 GetFormat 只會傳回本身。)
您可以傳遞實作的 IFormatProvider自訂物件。其 GetFormat 方法會具現化並傳回 NumberFormatInfo 提供格式信息的物件。

如果 provider 為 null，則會 value 根據 NumberFormatInfo 目前文化特性的物件來解譯的格式。

另請參閱

TryParse

適用於

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將所指定唯讀字元範圍中具有所指定樣式的數字表示法轉換為其 BigInteger 對等項目。

public static System.Numerics.BigInteger Parse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

public static System.Numerics.BigInteger Parse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);

static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> System.Numerics.BigInteger

Public Shared Function Parse (value As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As BigInteger

參數

value: ReadOnlySpan<Char>

包含要轉換之數字的唯讀字元範圍。

style: NumberStyles

指定 value 可以使用的格式之列舉值的位元組合。

provider: IFormatProvider

提供關於 value 之特定文化特性格式資訊的物件。

傳回

BigInteger

值，相當於以 value 參數指定的數字。

實作

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

例外狀況

ArgumentException

style 不是 NumberStyles 值。

-或-

style 包含 AllowHexSpecifier 或 HexNumber 旗標和其他值。

ArgumentNullException

value 為 null。

FormatException

value 不符合由 style 所指定的輸入模式。

備註

參數 style 會定義樣式專案 (，例如空格符、正負號符號、群組分隔符符號，或參數中 value 允許的小數點符號) ，讓剖析作業成功。 styles 必須是列舉中的 NumberStyles 位旗標組合。如果style包含十六進位值的表示法、當數字系統 (十進位或十六進位) value 只有在運行時間才知道，或您想要不允許中的value空格符或登入符號時，參數會使這個方法多載很有用value。

根據的值 style， value 參數可能包含下列元素：

[ws][$][sign][digits，]digits[.fractional_digits][E[sign]exponential_digits][ws]

如果 style 包含 NumberStyles.AllowHexSpecifier，參數 value 可能包含下列元素：

[ws]hexdigits[ws]

在方括號 ([ 和 ]) 中的項目是選擇性的項目。下表說明每個元素。

元素	描述
ws	選擇性空格符。如果包含旗標，則空格元可以出現在 `value` 開頭，如果`style`包含 NumberStyles.AllowTrailingWhite 旗標，則會出現在結尾`value`。NumberStyles.AllowLeadingWhite`style`
$	特定文化特性的貨幣符號。中的位置`value`是由 NumberFormatInfo.CurrencyNegativePattern 參數所指示`provider`之文化特性的和 NumberFormatInfo.CurrencyPositivePattern 屬性所定義。如果`style`包含 NumberStyles.AllowCurrencySymbol 旗標，則目前文化特性的貨幣符號可能會出現在中`value`。
簽署	選擇性符號。如果包含旗標，則符號可以出現在 `value` 開頭，如果包含 NumberStyles.AllowTrailingSign 旗標，則會出現在結尾`stylevalue`。NumberStyles.AllowLeadingSign`style` 如果包含 NumberStyles.AllowParentheses 旗標，則可以在中使用`value`括弧來表示負值`style`。
數字 fractional_digits exponential_digits	從 0 到 9 的數位序列。對於 fractional_digits，只有數位0有效。
,	特定文化特性的群組分隔符符號。如果包含旗標，則指定`provider`文化特性的群組分隔符號可以出現在中`value`。NumberStyles.AllowThousands`style`
.	特定文化特性的小數點符號。如果包含旗標，則所指定`provider`文化特性的小數點符號可能會出現在中`value`。NumberStyles.AllowDecimalPoint`style` 只有數位 0 可以顯示為小數位數，剖析作業才會成功;如果 fractional_digits 包含任何其他數位， FormatException 則會擲回。
E	“e” 或 “E” 字元，表示該值是以指數 (科學) 表示法表示。如果`style`包含 NumberStyles.AllowExponent 旗標，參數`value`可以代表指數表示法的數位。
hexdigits	從 0 到 f 或 0 到 F 的十六進位數位序列。

注意

中任何終止的 NUL (U+0000) 字元 s 都會被剖析作業忽略，不論自變數的值 style 為何。

value只有數字 (對應至NumberStyles.None樣式) 一律會成功剖析的。中可能存在但不需要存在的value其餘NumberStyles成員控件專案。下表指出個別 NumberStyles 成員如何影響中 value可能存在的專案。

NumberStyles 值	除了數位之外，值中允許的專案
None	僅限 digits 元素。
AllowDecimalPoint	小數點 (.) 和小數位數元素。
AllowExponent	表示指數表示法的「e」或「E」字元。以及 exponential_digits。
AllowLeadingWhite	開頭的 `value`ws 元素。
AllowTrailingWhite	結尾處的 `value`ws 專案。
AllowLeadingSign	開頭的`value`符號專案。
AllowTrailingSign	結尾的`value`符號專案。
AllowParentheses	以括弧括住數值形式的 sign 元素。
AllowThousands	群組分隔符 (，) 元素。
AllowCurrencySymbol	貨幣 ($) 專案。
Currency	所有元素。不過， `value` 不能以指數表示法表示十六進位數位或數位。
Float	開頭或結尾的 `value`ws 元素，在開頭`value`為符號，而小數點 (.) 符號。參數 `value` 也可以使用指數表示法。
Number	`ws`、`sign`、群組分隔符 (、) 和小數點 (.) 專案。
Any	所有元素。不過， `value` 不能代表十六進位數位。

NumberStyles與其他允許但不需要在中valueNumberStyles.AllowHexSpecifier存在特定樣式專案的值不同，樣式值表示中的value個別數值字元一律會解譯為十六進位字元。有效的十六進位字元為0-9、A-F和 a-f。唯一可以與 style 參數結合的其他旗標是 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。 (列舉 NumberStyles 包含複合編號樣式， HexNumber其中包含空格符旗標.)

參數 provider 是實作 IFormatProvider 。其 GetFormat 方法會傳 NumberFormatInfo 回物件，提供有關格式 value的文化特性特定資訊。一般而言， provider 可以是下列任一項：

CultureInfo物件，表示提供數值格式資訊的文化特性。其 GetFormat 方法會傳 NumberFormatInfo 回提供數值格式信息的物件。
提供 NumberFormatInfo 格式化信息的物件。 (其實作 GetFormat 只會傳回本身。)
實作 IFormatProvider 和使用 GetFormat 方法的自定義物件，可具現化並傳回 NumberFormatInfo 提供格式化信息的物件。

如果為 providernull，則會 NumberFormatInfo 使用目前文化特性的物件。

另請參閱

TryParse

適用於

Parse(String, NumberStyles, IFormatProvider)

來源:: BigInteger.cs

來源:: BigInteger.cs

來源:: BigInteger.cs

將數字的字串表示 (使用指定樣式和特定文化特性的格式) 轉換為其相等的 BigInteger。

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider);

public:
 static System::Numerics::BigInteger Parse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<System::Numerics::BigInteger>::Parse;

public static System.Numerics.BigInteger Parse (string value, System.Globalization.NumberStyles style, IFormatProvider provider);

public static System.Numerics.BigInteger Parse (string value, System.Globalization.NumberStyles style, IFormatProvider? provider);

static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> System.Numerics.BigInteger

Public Shared Function Parse (value As String, style As NumberStyles, provider As IFormatProvider) As BigInteger

參數

value: String

字串，其包含要轉換的數字。

style: NumberStyles

指定 value 可以使用的格式之列舉值的位元組合。

provider: IFormatProvider

提供關於 value 之特定文化特性格式資訊的物件。

傳回

BigInteger

值，相當於以 value 參數指定的數字。

實作

Parse(String, NumberStyles, IFormatProvider)

例外狀況

ArgumentException

style 不是 NumberStyles 值。

-或-

style 包含 AllowHexSpecifier 或 HexNumber 旗標和其他值。

ArgumentNullException

value 為 null。

FormatException

value 不符合由 style 所指定的輸入模式。

範例

下列範例會使用和 provider 參數的各種值style組合，對方法進行數次呼叫Parse(String, NumberStyles, IFormatProvider)。

// Call parse with default values of style and provider
Console.WriteLine(BigInteger.Parse("  -300   ",
                  NumberStyles.Integer, CultureInfo.CurrentCulture));
// Call parse with default values of style and provider supporting tilde as negative sign
Console.WriteLine(BigInteger.Parse("   ~300  ",
                                   NumberStyles.Integer, new BigIntegerFormatProvider()));
// Call parse with only AllowLeadingWhite and AllowTrailingWhite
// Exception thrown because of presence of negative sign
try
{
   Console.WriteLine(BigInteger.Parse("    ~300   ",
                                NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite,
                                new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}
// Call parse with only AllowHexSpecifier
// Exception thrown because of presence of negative sign
try
{
   Console.WriteLine(BigInteger.Parse("-3af", NumberStyles.AllowHexSpecifier,
                                      new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}
// Call parse with only NumberStyles.None
// Exception thrown because of presence of white space and sign
try
{
   Console.WriteLine(BigInteger.Parse(" -300 ", NumberStyles.None,
                                      new BigIntegerFormatProvider()));
}
catch (FormatException e)
{
   Console.WriteLine("{0}: \n   {1}", e.GetType().Name, e.Message);
}
// The example displays the followingoutput:
//       -300
//       -300
//       FormatException:
//          The value could not be parsed.
//       FormatException:
//          The value could not be parsed.
//       FormatException:
//          The value could not be parsed.

' Call parse with default values of style and provider
Console.WriteLine(BigInteger.Parse("  -300   ", _
                  NumberStyles.Integer, CultureInfo.CurrentCulture))
' Call parse with default values of style and provider supporting tilde as negative sign
Console.WriteLine(BigInteger.Parse("   ~300  ", _
                                   NumberStyles.Integer, New BigIntegerFormatProvider()))
' Call parse with only AllowLeadingWhite and AllowTrailingWhite
' Exception thrown because of presence of negative sign
Try
   Console.WriteLIne(BigInteger.Parse("    ~300   ", _
                                      NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try                                   
' Call parse with only AllowHexSpecifier
' Exception thrown because of presence of negative sign
Try
   Console.WriteLIne(BigInteger.Parse("-3af", NumberStyles.AllowHexSpecifier, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try                                 
' Call parse with only NumberStyles.None
' Exception thrown because of presence of white space and sign
Try
   Console.WriteLIne(BigInteger.Parse(" -300 ", NumberStyles.None, _
                                      New BigIntegerFormatProvider()))
Catch e As FormatException
   Console.WriteLine("{0}: {1}   {2}", e.GetType().Name, vbCrLf, e.Message)
End Try
' The example displays the following output:
'       -300
'       -300
'       FormatException:
'          The value could not be parsed.
'       FormatException:
'          The value could not be parsed.
'       FormatException:
'          The value could not be parsed.

方法的一些個別呼叫 Parse(String, NumberStyles, IFormatProvider) 會傳遞下列 BigIntegerFormatProvider 類別的實例，此實例會將磚 (~) 定義為負號。

public class BigIntegerFormatProvider : IFormatProvider
{
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(NumberFormatInfo))
      {
         NumberFormatInfo numberFormat = new NumberFormatInfo();
         numberFormat.NegativeSign = "~";
         return numberFormat;
      }
      else
      {
         return null;
      }
   }
}

Public Class BigIntegerFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                            Implements IFormatProvider.GetFormat
      If formatType Is GetType(NumberFormatInfo) Then
         Dim numberFormat As New NumberFormatInfo
         numberFormat.NegativeSign = "~"
         Return numberFormat
      Else
         Return Nothing
      End If      
   End Function
End Class

備註

根據的值 style， value 參數可能包含下列元素：

[ws][$][sign][digits，]digits[.fractional_digits][E[sign]exponential_digits][ws]

如果 style 包含 NumberStyles.AllowHexSpecifier，則 value 參數可能包含下列元素：

[ws]hexdigits[ws]

在方括號 ([ 和 ]) 中的項目是選擇性的項目。下表說明每個元素。

元素	描述
ws	選擇性空格符。如果包含旗標，則空格元可以出現在 `value` 開頭，如果`style`包含 NumberStyles.AllowTrailingWhite 旗標，則會出現在結尾`value`。NumberStyles.AllowLeadingWhite`style`
$	特定文化特性的貨幣符號。字串中的位置是由 NumberFormatInfo.CurrencyNegativePattern 參數所指示`provider`之文化特性的和 NumberFormatInfo.CurrencyPositivePattern 屬性所定義。如果`style`包含 NumberStyles.AllowCurrencySymbol 旗標，則目前文化特性的貨幣符號可能會出現在中`value`。
簽署	選擇性符號。如果包含旗標，則符號可以出現在 `value` 開頭，如果包含 NumberStyles.AllowTrailingSign 旗標，則會出現在結尾`stylevalue`。NumberStyles.AllowLeadingSign`style` 如果包含 NumberStyles.AllowParentheses 旗標，則可以在中使用`value`括弧來表示負值`style`。
數字 fractional_digits exponential_digits	從 0 到 9 的數位序列。對於 fractional_digits，只有數位0有效。
,	特定文化特性的群組分隔符符號。如果`style`包含 NumberStyles.AllowThousands 旗標，則所`provider`指定文化特性的群組分隔符可以出現在 `value` 中。
.	特定文化特性的小數點符號。如果包含旗標，則所`provider`指定文化特性的小數點符號可以出現在中`value`。NumberStyles.AllowDecimalPoint`style` 只有數位 0 可以顯示為小數位數，剖析作業才會成功;如果 fractional_digits 包含任何其他數位， FormatException 則會擲回。
E	“e” 或 “E” 字元，表示值是以指數 (科學) 表示法表示。如果`style`包含旗標，參數`value`可以表示指數表示法的數位NumberStyles.AllowExponent。
hexdigits	從 0 到 f 或 0 到 F 的十六進位數位序列。

注意

不論自變數的值style為何，剖析作業都會忽略中s任何終止的 NUL (U+0000) 字元。

只有數位的字串， (對應至 NumberStyles.None 樣式) 一律會成功剖析。大部分剩餘 NumberStyles 的成員控件元素可能存在，但不需要出現在輸入字串中。下表指出個別 NumberStyles 成員如何影響中 value可能存在的專案。

NumberStyles 值	除了數位之外，值中允許的專案
None	僅限 digits 元素。
AllowDecimalPoint	小數點 (.) 和小數位數元素。
AllowExponent	表示指數表示法的「e」或「E」字元。以及 exponential_digits。
AllowLeadingWhite	開頭的 `value`ws 元素。
AllowTrailingWhite	結尾處的 `value`ws 元素。
AllowLeadingSign	開頭的 `value`sign 元素。
AllowTrailingSign	結尾處的`value`符號專案。
AllowParentheses	以括弧括住數值形式的 sign 元素。
AllowThousands	群組分隔符 (，) 專案。
AllowCurrencySymbol	貨幣 ($) 元素。
Currency	所有元素。不過， `value` 不能代表十六進位數或指數表示法中的數位。
Float	開頭或結尾處的 `value`ws 元素，會在開頭`value`加上小數點 (.) 符號。參數 `value` 也可以使用指數表示法。
Number	`ws`、`sign`、群組分隔符 (、) 和小數點 (.) 元素。
Any	所有元素。不過， `value` 不能代表十六進位數。

重要

與其他允許但不需要中value特定樣式元素存在的值NumberStyles不同，樣式NumberStyles.AllowHexSpecifier值表示中的value個別數值字元一律會解譯為十六進位字元。有效的十六進位字元為0-9、A-F和 a-f。唯一可以與 style 參數結合的其他旗標為 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。 (列舉 NumberStyles 包含複合數字樣式， HexNumber其中包含空格符旗標.)

注意

如果 value 是十六進位數位的字串表示法，則不能在前面加上任何裝飾 (，例如 0x 或 &h) ，將它區分為十六進位數。這會導致轉換失敗。

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "80", "E293", "F9A2FF", "FFFFFFFF",
                              "080", "0E293", "0F9A2FF", "0FFFFFFFF",
                              "0080", "00E293", "00F9A2FF", "00FFFFFFFF" };
      foreach (string hexString in hexStrings)
      {
         BigInteger number = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
      }
   }
}
// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim hexStrings() As String = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                                     "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                                     "0080", "00E293", "00F9A2FF", "00FFFFFFFF" }
      For Each hexString As String In hexStrings
         Dim number As BigInteger = BigInteger.Parse(hexString, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
      Next         
   End Sub
End Module
' The example displays the following output:
'       Converted 0x80 to -128.
'       Converted 0xE293 to -7533.
'       Converted 0xF9A2FF to -417025.
'       Converted 0xFFFFFFFF to -1.
'       Converted 0x080 to 128.
'       Converted 0x0E293 to 58003.
'       Converted 0x0F9A2FF to 16360191.
'       Converted 0x0FFFFFFFF to 4294967295.
'       Converted 0x0080 to 128.
'       Converted 0x00E293 to 58003.
'       Converted 0x00F9A2FF to 16360191.
'       Converted 0x00FFFFFFFF to 4294967295.

參數 provider 是實作 IFormatProvider 。其 GetFormat 方法會 NumberFormatInfo 傳回物件，這個物件提供有關格式 value的文化特性特定資訊。一般而言， provider 可以是下列任一項：

CultureInfo物件，表示提供數值格式資訊的文化特性。其 GetFormat 方法會 NumberFormatInfo 傳回提供數值格式信息的物件。
提供 NumberFormatInfo 格式化信息的物件。 (其實作 GetFormat 只會傳回本身。)
實作 IFormatProvider 和使用方法的 GetFormat 自定義物件，可具現化及傳回 NumberFormatInfo 提供格式化信息的物件。

如果 provider 為 null，則會 NumberFormatInfo 使用目前文化特性的物件。

另請參閱

TryParse

適用於

BigInteger.Parse 方法

定義

多載

Parse(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Parse(ReadOnlySpan<Char>, IFormatProvider)

參數

傳回

實作

適用於

Parse(String, NumberStyles)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Parse(String, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

參數

傳回

實作

例外狀況

備註

另請參閱

適用於

Parse(String, NumberStyles, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

意見反應

其他資源