Int16.Parse 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

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

將數位的字串表示轉換為其相等的16位帶正負號的整數。

多載

Parse(String, NumberStyles, IFormatProvider)	將指定樣式和特定文化特性格式之數位的字串表示轉換為其16位帶正負號的整數對等。
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	將指定樣式和特定文化特性格式的數位範圍表示轉換為其16位帶正負號的整數對等。
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	將UTF-8字元的範圍剖析為值。
Parse(String, IFormatProvider)	將指定之特定文化特性格式之數位的字串表示轉換為其相等的16位帶正負號整數。
Parse(String)	將數位的字串表示轉換為其相等的16位帶正負號的整數。
Parse(ReadOnlySpan<Char>, IFormatProvider)	將字元範圍剖析為值。
Parse(ReadOnlySpan<Byte>, IFormatProvider)	將UTF-8字元的範圍剖析為值。
Parse(String, NumberStyles)	將指定樣式中數位的字串表示轉換為其相等的16位帶正負號的整數。

Parse(String, NumberStyles, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將指定樣式和特定文化特性格式之數位的字串表示轉換為其16位帶正負號的整數對等。

public:
 static short Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);

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

public static short Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);

public static short Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);

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

Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Short

參數

s: String

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

style: NumberStyles

列舉值的位元組合，表示 s中可以存在的樣式專案。要指定的一般值是 Integer。

provider: IFormatProvider

IFormatProvider，提供與 s相關的特定文化特性格式資訊。

傳回

Int16

16 位帶正負號的整數，相當於 s中指定的數位。

實作

Parse(String, NumberStyles, IFormatProvider)

例外狀況

ArgumentNullException

s null。

ArgumentException

style 不是 NumberStyles 值。

-或-

style 不是 AllowHexSpecifier 和 HexNumber 值的組合。

FormatException

s 的格式與 style不相容。

OverflowException

s 代表小於 Int16.MinValue 或大於 Int16.MaxValue的數位。

-或-

s 包含非零的小數位數。

範例

下列範例使用各種 style 和 provider 參數來剖析 Int16 值的字串表示。

String^ value;
Int16 number;
NumberStyles style;

// Parse string using "." as the thousands separator 
// and " " as the decimal separator.
value = "19 694,00";
style = NumberStyles::AllowDecimalPoint | NumberStyles::AllowThousands;
CultureInfo^ provider = gcnew CultureInfo("fr-FR");

number = Int16::Parse(value, style, provider);
Console::WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '19 694,00' converted to 19694.

try
{
   number = Int16::Parse(value, style, CultureInfo::InvariantCulture);
   Console::WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '19 694,00'.

// Parse string using "$" as the currency symbol for en_GB and
// en-US cultures.
value = "$6,032.00";
style = NumberStyles::Number | NumberStyles::AllowCurrencySymbol;
provider = gcnew CultureInfo("en-GB");

try
{
   number = Int16::Parse(value, style, CultureInfo::InvariantCulture);
   Console::WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '$6,032.00'.
                        
provider = gcnew CultureInfo("en-US");
number = Int16::Parse(value, style, provider);
Console::WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '$6,032.00' converted to 6032.

string value;
short number;
NumberStyles style;
CultureInfo provider;

// Parse string using "." as the thousands separator
// and " " as the decimal separator.
value = "19 694,00";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
provider = new CultureInfo("fr-FR");

number = Int16.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '19 694,00' converted to 19694.

try
{
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '19 694,00'.

// Parse string using "$" as the currency symbol for en_GB and
// en-US cultures.
value = "$6,032.00";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
provider = new CultureInfo("en-GB");

try
{
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '$6,032.00'.

provider = new CultureInfo("en-US");
number = Int16.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '$6,032.00' converted to 6032.

// Parse string using "." as the thousands separator
// and " " as the decimal separator.
let value = "19 694,00"
let style = NumberStyles.AllowDecimalPoint ||| NumberStyles.AllowThousands
let provider = CultureInfo "fr-FR"

let number = Int16.Parse(value, style, provider)
printfn $"'{value}' converted to {number}." 
// Displays:
//    '19 694,00' converted to 19694.

try
    let number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
    printfn $"'{value}' converted to {number}." 
with :? FormatException ->
    printfn $"Unable to parse '{value}'."
// Displays:
//    Unable to parse '19 694,00'.

// Parse string using "$" as the currency symbol for en_GB and
// en-US cultures.
let value = "$6,032.00"
let style = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol

try
    let number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
    printfn $"'{value}' converted to {number}." 
with :? FormatException ->
    printfn $"Unable to parse '{value}'."
// Displays:
//    Unable to parse '$6,032.00'.

let provider = CultureInfo "en-US"
let number = Int16.Parse(value, style, provider)
printfn $"'{value}' converted to {number}."
// Displays:
//    '$6,032.00' converted to 6032.

Dim value As String
Dim number As Short
Dim style As NumberStyles
Dim provider As CultureInfo

' Parse string using "." as the thousands separator 
' and " " as the decimal separator.
value = "19 694,00"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
provider = New CultureInfo("fr-FR")

number = Int16.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '19 694,00' converted to 19694.

Try
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '19 694,00'.

' Parse string using "$" as the currency symbol for en_GB and
' en-US cultures.
value = "$6,032.00"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
provider = New CultureInfo("en-GB")

Try
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '$6,032.00'.
                        
provider = New CultureInfo("en-US")
number = Int16.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '$6,032.00' converted to 6032.

備註

style 參數會定義 s 參數中允許的樣式專案（例如空格符或正負號），讓剖析作業成功。它必須是來自 NumberStyles 列舉的位旗標組合。根據 style的值，s 參數可能包含下列元素：

[ws][$][sign][digits，]digits[.fractional_digits][e[sign]digits][ws]

或者，如果 style 包含 AllowHexSpecifier：

[ws]hexdigits[ws]

方括弧（[ 和 ]）中的元素是選擇性的。下表描述每個元素。

元素	描述
ws	選擇性的空格符。如果 `style` 包含 NumberStyles.AllowLeadingWhite 旗標，或 `style` 包含 NumberStyles.AllowTrailingWhite 旗標，則空格符會出現在 `s` 開頭，或 `s` 結尾。
$	特定文化特性的貨幣符號。字串中的位置是由目前文化特性的 NumberFormatInfo.CurrencyPositivePattern 和 NumberFormatInfo.CurrencyNegativePattern 屬性所定義。如果 `style` 包含 NumberStyles.AllowCurrencySymbol 旗標，則目前的文化特性貨幣符號可能會出現在 `s` 中。
簽署	選擇性符號。如果 `style` 包含 NumberStyles.AllowLeadingSign 旗標，則符號可能會出現在 `s` 開頭，如果 `style` 包含 NumberStyles.AllowTrailingSign 旗標，則它可能會出現在 `s` 結尾。括弧可用於 `s`，如果 `style` 包含 NumberStyles.AllowParentheses 旗標，則表示負值。
位數	從 0 到 9 的數位序列。
、	特定文化特性的千位分隔符符號。如果 `style` 包含 NumberStyles.AllowThousands 旗標，則目前文化特性的千位分隔符符號可能會出現在 `s` 中。
。	特定文化特性的小數點符號。如果 `style` 包含 NumberStyles.AllowDecimalPoint 旗標，則目前文化特性的小數點符號可能會出現在 `s` 中。
fractional_digits	0 位數的序列。如果 `style` 包含 NumberStyles.AllowDecimalPoint 旗標，則小數字數可以出現在 `s` 中。如果 0 以外的任何數字出現在 fractional_digits中，則方法會擲回 OverflowException。
e	'e' 或 'E' 字元，表示 `s` 可以用指數表示法表示。如果 `style` 包含 NumberStyles.AllowExponent 旗標，`s` 參數就可以以指數表示法來表示數位。不過，`s` 參數必須代表 Int16 數據類型範圍中的數位，而且不能有非零分數位件。
hexdigits	從 0 到 f 或 0 到 F 的十六進位數位序列。

注意

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

只有 位數的字串 一律會成功剖析 NumberStyles.None 樣式。其餘大部分 NumberStyles 成員控件元素，這些元素可能不是必須存在於此輸入字串中。下表指出個別 NumberStyles 成員如何影響 s中可能出現的專案。

非複合 NumberStyles 值	除了數位以外，允許的元素
NumberStyles.None	只有十進位數。
NumberStyles.AllowDecimalPoint	。和 fractional_digits 元素。不過，fractional_digits 必須只包含一或多個 0 位數或擲回 OverflowException。
NumberStyles.AllowExponent	`s` 參數也可以使用指數表示法。
NumberStyles.AllowLeadingWhite	`s`開頭的 ws ws 專案。
NumberStyles.AllowTrailingWhite	`s`結尾的 ws 專案。
NumberStyles.AllowLeadingSign	位數之前，可能會出現符號。
NumberStyles.AllowTrailingSign	符號可以在位數之後出現。
NumberStyles.AllowParentheses	以括弧括住數值的括弧形式，符號專案。
NumberStyles.AllowThousands	、專案。
NumberStyles.AllowCurrencySymbol	$ 專案。

如果使用 NumberStyles.AllowHexSpecifier 旗標，s 必須是不含前置詞之十六進位值的字串表示法。例如，“9AF3” 剖析成功，但 “0x9AF3” 則不會。 style 中唯一可以存在的其他旗標是 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。（NumberStyles 列舉具有包含兩個空格符旗標的複合數字樣式 NumberStyles.HexNumber。

provider 參數是 IFormatProvider 實作，其 GetFormat 方法會取得 NumberFormatInfo 物件。 NumberFormatInfo 物件提供有關 s格式的文化特性特定資訊。如果 provider 是 null，則會使用目前文化特性的 NumberFormatInfo 物件。

另請參閱

NumberStyles
ToString()
.NET 中剖析數值字串

適用於

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將指定樣式和特定文化特性格式的數位範圍表示轉換為其16位帶正負號的整數對等。

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

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

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

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

參數

s: ReadOnlySpan<Char>

範圍，包含表示要轉換之數位的字元。

style: NumberStyles

列舉值的位元組合，表示 s中可以存在的樣式專案。要指定的一般值是 Integer。

provider: IFormatProvider

IFormatProvider，提供與 s相關的特定文化特性格式資訊。

傳回

Int16

16 位帶正負號的整數，相當於 s中指定的數位。

實作

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

適用於

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

將UTF-8字元的範圍剖析為值。

public static short Parse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

static member Parse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider -> int16

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Short

參數

utf8Text: ReadOnlySpan<Byte>

要剖析的UTF-8字元範圍。

style: NumberStyles

數字樣式的位元組合，可以存在於 utf8Text中。

provider: IFormatProvider

物件，提供與 utf8Text相關的特定文化特性格式資訊。

傳回

Int16

剖析 utf8Text的結果。

實作

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

適用於

Parse(String, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將指定之特定文化特性格式之數位的字串表示轉換為其相等的16位帶正負號整數。

public:
 static short Parse(System::String ^ s, IFormatProvider ^ provider);

public:
 static short Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<short>::Parse;

public static short Parse (string s, IFormatProvider provider);

public static short Parse (string s, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> int16

Public Shared Function Parse (s As String, provider As IFormatProvider) As Short

參數

s: String

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

provider: IFormatProvider

IFormatProvider，提供與 s相關的特定文化特性格式資訊。

傳回

Int16

16 位帶正負號的整數，相當於 s中指定的數位。

實作

Parse(String, IFormatProvider)

例外狀況

ArgumentNullException

s null。

FormatException

s 格式不正確。

OverflowException

s 代表小於 Int16.MinValue 或大於 Int16.MaxValue的數位。

範例

下列範例會使用 Int16.Parse(String, IFormatProvider) 方法剖析 Int16 值的字串表示。

String^ stringToConvert;
Int16 number;

stringToConvert = " 214 ";
try
{
   number = Int16::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   Console::WriteLine("'{0'} is out of range of the Int16 data type.", 
                     stringToConvert);
}

stringToConvert = " + 214";                     
try
{
   number = Int16::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   Console::WriteLine("'{0'} is out of range of the Int16 data type.", 
                     stringToConvert);
}

stringToConvert = " +214 "; 
try
{
   number = Int16::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   Console::WriteLine("'{0'} is out of range of the Int16 data type.", 
                     stringToConvert);
}
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214'.
//       Converted ' +214 ' to 214.

string stringToConvert;
short number;

stringToConvert = " 214 ";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}

stringToConvert = " + 214";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}

stringToConvert = " +214 ";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214'.
//       Converted ' +214 ' to 214.

let stringToConvert = " 214 "
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with 
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

let stringToConvert = " + 214"
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with 
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException -> 
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

let stringToConvert = " +214 "
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214'.
//       Converted ' +214 ' to 214.

Dim stringToConvert As String
Dim number As Short

stringToConvert = " 214 "
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try

stringToConvert = " + 214"                                 
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try

stringToConvert = " +214 " 
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214'.
'       Converted ' +214 ' to 214.

備註

s 參數包含一些表單：

[ws][sign]digits[ws]

方括弧（[ 和 ]）中的元素是選擇性的。下表描述每個元素。

元素	描述
ws	選擇性的空格符。
標誌	選擇性符號。
數位	範圍從 0 到 9 的數位序列。

s 參數是使用 NumberStyles.Integer 樣式來解譯。除了十進位數之外，s中只允許前置和尾端空格與前置符號。若要明確定義樣式專案以及可存在於 s中的特定文化特性格式資訊，請使用 Int16.Parse(String, NumberStyles, IFormatProvider) 方法。

provider 參數是取得 NumberFormatInfo 物件的 IFormatProvider 實作。 NumberFormatInfo 提供 s格式的文化特性特定資訊。如果 provider 是 null，則會使用目前文化特性的 NumberFormatInfo。

另請參閱

ToString()
TryParse
.NET 中剖析數值字串

適用於

Parse(String)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將數位的字串表示轉換為其相等的16位帶正負號的整數。

public:
 static short Parse(System::String ^ s);

public static short Parse (string s);

static member Parse : string -> int16

Public Shared Function Parse (s As String) As Short

參數

s: String

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

傳回

Int16

16 位帶正負號的整數，相當於 s中包含的數位。

例外狀況

ArgumentNullException

s null。

FormatException

s 格式不正確。

OverflowException

s 代表小於 Int16.MinValue 或大於 Int16.MaxValue的數位。

範例

下列範例示範如何使用 Int16.Parse(String) 方法，將字串值轉換成 16 位帶正負號的整數值。產生的整數值接著會顯示至主控台。

String^ value;
Int16 number;
   
value = " 12603 ";
try
{
   number = Int16::Parse(value);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", 
                      value);
}
   
value = " 16,054";
try
{
   number = Int16::Parse(value);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", 
                     value);
}
                           
value = " -17264";
try
{
   number = Int16::Parse(value);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", 
                      value);
}
// The example displays the following output to the console:
//       Converted ' 12603 ' to 12603.
//       Unable to convert ' 16,054' to a 16-bit signed integer.
//       Converted ' -17264' to -17264.

string value;
short number;

value = " 12603 ";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}

value = " 16,054";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}

value = " -17264";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}
// The example displays the following output to the console:
//       Converted ' 12603 ' to 12603.
//       Unable to convert ' 16,054' to a 16-bit signed integer.
//       Converted ' -17264' to -17264.

let value = " 12603 "
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}." 
with :? FormatException -> 
    printfn $"Unable to convert '{value}' to a 16-bit signed integer."

let value = " 16,054"
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn "Unable to convert '{value}' to a 16-bit signed integer."
                    
let value = " -17264"
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn "Unable to convert '{value}' to a 16-bit signed integer."
    

// The example displays the following output to the console:
//       Converted ' 12603 ' to 12603.
//       Unable to convert ' 16,054' to a 16-bit signed integer.
//       Converted ' -17264' to -17264.

Dim value As String
Dim number As Short

value = " 12603 "
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try

value = " 16,054"
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try
                        
value = " -17264"
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try
' The example displays the following output to the console:
'       Converted ' 12603 ' to 12603.
'       Unable to convert ' 16,054' to a 16-bit signed integer.
'       Converted ' -17264' to -17264.

備註

s 參數包含一些表單：

[ws][sign]digits[ws]

方括弧（[ 和 ]）中的元素是選擇性的。下表描述每個元素。

元素	描述
ws	選擇性的空格符。
簽署	選擇性符號。
位數	範圍從 0 到 9 的數位序列。

s 參數是使用 NumberStyles.Integer 樣式來解譯。除了整數值的十進位數之外，只允許前置和尾端空格與前置正負號。若要明確定義可以存在於 s中的樣式專案，請使用 Int16.Parse(String, NumberStyles) 或 Parse 方法。

s 參數是使用目前系統文化特性初始化之 NumberFormatInfo 物件中的格式資訊來剖析。如需詳細資訊，請參閱 CurrentInfo。若要使用其他文化特性的格式資訊剖析字串，請使用 Int16.Parse(String, IFormatProvider) 或 Int16.Parse(String, NumberStyles, IFormatProvider) 方法。

另請參閱

ToString()
.NET 中剖析數值字串

適用於

Parse(ReadOnlySpan<Char>, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將字元範圍剖析為值。

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

public static short Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> int16

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

參數

s: ReadOnlySpan<Char>

要剖析的字元範圍。

provider: IFormatProvider

物件，提供與 s相關的特定文化特性格式資訊。

傳回

Int16

剖析 s的結果。

實作

Parse(ReadOnlySpan<Char>, IFormatProvider)

適用於

Parse(ReadOnlySpan<Byte>, IFormatProvider)

來源:: Int16.cs

來源:: Int16.cs

將UTF-8字元的範圍剖析為值。

public:
 static short Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<short>::Parse;

public static short Parse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

static member Parse : ReadOnlySpan<byte> * IFormatProvider -> int16

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Short

參數

utf8Text: ReadOnlySpan<Byte>

要剖析的UTF-8字元範圍。

provider: IFormatProvider

物件，提供與 utf8Text相關的特定文化特性格式資訊。

傳回

Int16

剖析 utf8Text的結果。

實作

Parse(ReadOnlySpan<Byte>, IFormatProvider)

適用於

Parse(String, NumberStyles)

來源:: Int16.cs

來源:: Int16.cs

來源:: Int16.cs

將指定樣式中數位的字串表示轉換為其相等的16位帶正負號的整數。

public:
 static short Parse(System::String ^ s, System::Globalization::NumberStyles style);

public static short Parse (string s, System.Globalization.NumberStyles style);

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

Public Shared Function Parse (s As String, style As NumberStyles) As Short

參數

s: String

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

style: NumberStyles

列舉值的位元組合，表示可以存在於 s中的樣式專案。要指定的一般值是 Integer。

傳回

Int16

16 位帶正負號的整數，相當於 s中指定的數位。

例外狀況

ArgumentNullException

s null。

ArgumentException

style 不是 NumberStyles 值。

-或-

style 不是 AllowHexSpecifier 和 HexNumber 值的組合。

FormatException

s 的格式與 style不相容。

OverflowException

s 代表小於 Int16.MinValue 或大於 Int16.MaxValue的數位。

-或-

s 包含非零的小數位數。

範例

下列範例使用 Int16.Parse(String, NumberStyles) 方法來使用 en-US 文化特性剖析 Int16 值的字串表示。

using namespace System;
using namespace System::Globalization;

ref class ParseSample
{
public:
   static void Main()
   {
      String^ value;
      NumberStyles style;

      // Parse a number with a thousands separator (throws an exception).
      value = "14,644";
      style = NumberStyles::None;
      ParseSample::ParseToInt16(value, style);
      
      style = NumberStyles::AllowThousands;
      ParseToInt16(value, style);
      
      // Parse a number with a thousands separator and decimal point.
      value = "14,644.00";
      style = NumberStyles::AllowThousands | NumberStyles::Integer |
              NumberStyles::AllowDecimalPoint;
      ParseToInt16(value, style);
      
      // Parse a number with a fractional component (throws an exception).
      value = "14,644.001";
      ParseToInt16(value, style);
      
      // Parse a number in exponential notation.
      value = "145E02";
      style = style | NumberStyles::AllowExponent;
      ParseToInt16(value, style);
      
      // Parse a number in exponential notation with a positive sign.
      value = "145E+02";
      ParseToInt16(value, style);
      
      // Parse a number in exponential notation with a negative sign
      // (throws an exception).
      value = "145E-02";
      ParseToInt16(value, style);
   }

private:
   static void ParseToInt16(String^ value, NumberStyles style)
   {
      try
      {
         Int16 number = Int16::Parse(value, style);
         Console::WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException ^e)
      {
         Console::WriteLine("Unable to parse '{0}' with style {1}.", value, 
                            style);
      }
      catch (OverflowException ^e)
      {
         Console::WriteLine("'{0}' is out of range of the Int16 type.", value);
      }
   }
};

int main()
{
    ParseSample::Main();
    Console::ReadLine();
    return 0;
}
// The example displays the following output:
//       Unable to parse '14,644' with style None.
//       Converted '14,644' to 14644.
//       Converted '14,644.00' to 14644.
//       '14,644.001' is out of range of the Int16 type.
//       Converted '145E02' to 14500.
//       Converted '145E+02' to 14500.
//       '145E-02' is out of range of the Int16 type.

using System;
using System.Globalization;

public class ParseSample
{
   public static void Main()
   {
      string value;
      NumberStyles style;

      // Parse a number with a thousands separator (throws an exception).
      value = "14,644";
      style = NumberStyles.None;
      ParseToInt16(value, style);

      style = NumberStyles.AllowThousands;
      ParseToInt16(value, style);

      // Parse a number with a thousands separator and decimal point.
      value = "14,644.00";
      style = NumberStyles.AllowThousands | NumberStyles.Integer |
              NumberStyles.AllowDecimalPoint;
      ParseToInt16(value, style);

      // Parse a number with a fractional component (throws an exception).
      value = "14,644.001";
      ParseToInt16(value, style);

      // Parse a number in exponential notation.
      value = "145E02";
      style = style | NumberStyles.AllowExponent;
      ParseToInt16(value, style);

      // Parse a number in exponential notation with a positive sign.
      value = "145E+02";
      ParseToInt16(value, style);

      // Parse a number in exponential notation with a negative sign
      // (throws an exception).
      value = "145E-02";
      ParseToInt16(value, style);
   }

   private static void ParseToInt16(string value, NumberStyles style)
   {
      try
      {
         short number = Int16.Parse(value, style);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to parse '{0}' with style {1}.", value,
                           style.ToString());
      }
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range of the Int16 type.", value);
      }
   }
}
// The example displays the following output to the console:
//       Unable to parse '14,644' with style None.
//       Converted '14,644' to 14644.
//       Converted '14,644.00' to 14644.
//       '14,644.001' is out of range of the Int16 type.
//       Converted '145E02' to 14500.
//       Converted '145E+02' to 14500.
//       '145E-02' is out of range of the Int16 type.

open System
open System.Globalization

let parseToInt16 (value: string) (style: NumberStyles) =
    try
        let number = Int16.Parse(value, style)
        printfn $"Converted '{value}' to {number}."
    with
    | :? FormatException ->
        printfn $"Unable to parse '{value}' with style {style}."
    | :? OverflowException ->
        printfn $"'{value}' is out of range of the Int16 type."

[<EntryPoint>]
let main _ =
    // Parse a number with a thousands separator (throws an exception).
    let value = "14,644"
    let style = NumberStyles.None
    parseToInt16 value style

    let style = NumberStyles.AllowThousands
    parseToInt16 value style

    // Parse a number with a thousands separator and decimal point.
    let value = "14,644.00"
    let style = NumberStyles.AllowThousands ||| NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    parseToInt16 value style

    // Parse a number with a fractional component (throws an exception).
    let value = "14,644.001"
    parseToInt16 value style

    // Parse a number in exponential notation.
    let value = "145E02"
    let style = style ||| NumberStyles.AllowExponent
    parseToInt16 value style

    // Parse a number in exponential notation with a positive sign.
    let value = "145E+02"
    parseToInt16 value style

    // Parse a number in exponential notation with a negative sign
    // (throws an exception).
    let value = "145E-02"
    parseToInt16 value style

    0

// The example displays the following output to the console:
//       Unable to parse '14,644' with style None.
//       Converted '14,644' to 14644.
//       Converted '14,644.00' to 14644.
//       '14,644.001' is out of range of the Int16 type.
//       Converted '145E02' to 14500.
//       Converted '145E+02' to 14500.
//       '145E-02' is out of range of the Int16 type.

Imports System.Globalization

Module ParseSample
   Public Sub Main()
      Dim value As String 
      Dim style As NumberStyles
      
      ' Parse a number with a thousands separator (throws an exception).
      value = "14,644"
      style = NumberStyles.None
      ParseToInt16(value, style)
      
      style = NumberStyles.AllowThousands
      ParseToInt16(value, style)
      
      ' Parse a number with a thousands separator and decimal point.
      value = "14,644.00"
      style = NumberStyles.AllowThousands Or NumberStyles.Integer Or _
              NumberStyles.AllowDecimalPoint
      ParseToInt16(value, style)
      
      ' Parse a number with a fractional component (throws an exception).
      value = "14,644.001"
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation.
      value = "145E02"
      style = style Or NumberStyles.AllowExponent
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation with a positive sign.
      value = "145E+02"
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation with a negative sign
      ' (throws an exception).
      value = "145E-02"
      ParseToInt16(value, style)
   End Sub
   
   Private Sub ParseToInt16(value As String, style As NumberStyles)
      Try
         Dim number As Short = Int16.Parse(value, style)
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to parse '{0}' with style {1}.", value, _
                           style.ToString())
      Catch e As OverflowException
         Console.WriteLine("'{0}' is out of range of the Int16 type.", value)
      End Try
   End Sub   
End Module
' The example displays the following output to the console:
'       Unable to parse '14,644' with style None.
'       Converted '14,644' to 14644.
'       Converted '14,644.00' to 14644.
'       '14,644.001' is out of range of the Int16 type.
'       Converted '145E02' to 14500.
'       Converted '145E+02' to 14500.
'       '145E-02' is out of range of the Int16 type.

備註

style 參數會定義 s 參數中允許的樣式專案（例如空格符或符號符號），讓剖析作業成功。它必須是來自 NumberStyles 列舉的位旗標組合。根據 style的值，s 參數可能包含下列元素：

[ws][$][sign][digits，]digits[.fractional_digits][e[sign]digits][ws]

或者，如果 style 包含 AllowHexSpecifier：

[ws]hexdigits[ws]

方括弧（[ 和 ]）中的項目是選擇性專案。下表描述每個元素。

元素	描述
ws	選擇性的空格符。如果 `style` 包含 NumberStyles.AllowLeadingWhite 旗標，或 `style` 包含 NumberStyles.AllowTrailingWhite 旗標，則空格符會出現在 `s` 開頭，或 `s` 結尾。
$	特定文化特性的貨幣符號。字串中的位置是由目前文化特性的 NumberFormatInfo.CurrencyPositivePattern 和 NumberFormatInfo.CurrencyNegativePattern 屬性所定義。如果 `style` 包含 NumberStyles.AllowCurrencySymbol 旗標，則目前的文化特性貨幣符號可能會出現在 `s` 中。
簽署	選擇性符號。如果 `style` 包含 NumberStyles.AllowLeadingSign 旗標，則符號可能會出現在 `s` 開頭，如果 `style` 包含 NumberStyles.AllowTrailingSign 旗標，則它可能會出現在 `s` 結尾。括弧可用於 `s`，如果 `style` 包含 NumberStyles.AllowParentheses 旗標，則表示負值。
位數	從 0 到 9 的數位序列。
、	特定文化特性的千位分隔符符號。如果 `style` 包含 NumberStyles.AllowThousands 旗標，則目前文化特性的千位分隔符符號可能會出現在 `s` 中。
。	特定文化特性的小數點符號。如果 `style` 包含 NumberStyles.AllowDecimalPoint 旗標，則目前文化特性的小數點符號可能會出現在 `s` 中。
fractional_digits	0 位數的序列。如果 `style` 包含 NumberStyles.AllowDecimalPoint 旗標，則小數字數可以出現在 `s` 中。如果 0 以外的任何數字出現在 fractional_digits中，則方法會擲回 OverflowException。
e	'e' 或 'E' 字元，表示 `s` 可以用指數表示法表示。如果 `style` 包含 NumberStyles.AllowExponent 旗標，`s` 參數就可以以指數表示法來表示數位。不過，`s` 參數必須代表 Int16 數據類型範圍中的數位，而且不能有非零分數位件。
hexdigits	從 0 到 f 或 0 到 F 的十六進位數位序列。

注意

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

非複合 NumberStyles 值	除了數位以外，允許的元素
NumberStyles.None	只有十進位數。
NumberStyles.AllowDecimalPoint	。和 fractional_digits 元素。不過，fractional_digits 必須只包含一或多個 0 位數或擲回 OverflowException。
NumberStyles.AllowExponent	`s` 參數也可以使用指數表示法。
NumberStyles.AllowLeadingWhite	`s`開頭的 ws ws 專案。
NumberStyles.AllowTrailingWhite	`s`結尾的 ws 專案。
NumberStyles.AllowLeadingSign	位數之前，可能會出現符號。
NumberStyles.AllowTrailingSign	符號可以在位數之後出現。
NumberStyles.AllowParentheses	以括弧括住數值的括弧形式，符號專案。
NumberStyles.AllowThousands	、專案。
NumberStyles.AllowCurrencySymbol	$ 專案。

s 參數是使用目前系統文化特性初始化之 NumberFormatInfo 物件中的格式資訊來剖析。如需詳細資訊，請參閱 NumberFormatInfo.CurrentInfo。若要使用特定文化特性的格式資訊剖析 s，請呼叫 Int16.Parse(String, NumberStyles, IFormatProvider) 方法。

另請參閱

NumberStyles
ToString()
TryParse
.NET 中剖析數值字串

適用於

共用方式為

Int16.Parse 方法

定義

多載

Parse(String, NumberStyles, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

參數

傳回

實作

適用於

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

參數

傳回

實作

適用於

Parse(String, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

Parse(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Parse(ReadOnlySpan<Char>, IFormatProvider)

參數

傳回

實作

適用於

Parse(ReadOnlySpan<Byte>, IFormatProvider)

參數

傳回

實作

適用於

Parse(String, NumberStyles)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源