Int16.TryParse Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Преобразует строковое представление числа в 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

Перегрузки

Имя	Описание
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)	Пытается проанализировать диапазон символов UTF-8 в значение.
TryParse(ReadOnlySpan<Char>, Int16)	Преобразует представление диапазона числа в формате, зависяющем от языка и региональных параметров, в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.
TryParse(String, Int16)	Преобразует строковое представление числа в 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16)	Пытается проанализировать диапазон символов в значение.
TryParse(String, IFormatProvider, Int16)	Пытается проанализировать строку в значение.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16)	Пытается проанализировать диапазон символов UTF-8 в значение.
TryParse(ReadOnlySpan<Byte>, Int16)	Пытается преобразовать диапазон символов UTF-8, содержащий строковое представление числа в его 16-разрядное целое число со знаком.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int16)	Преобразует представление диапазона числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.
TryParse(String, NumberStyles, IFormatProvider, Int16)	Преобразует строковое представление числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)

Исходный код:

Int16.cs

Пытается проанализировать диапазон символов UTF-8 в значение.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IUtf8SpanParsable<short>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * int16 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

utf8Text

ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от utf8Textязыка и региональных параметров.

result

Int16

При возврате содержит результат успешного анализа utf8Text или неопределенного значения при сбое.

Возвращаемое значение

Boolean

true Значение , если utf8Text был успешно проанализирован; в противном случае false.

TryParse(ReadOnlySpan<Char>, Int16)

Исходный код:

Int16.cs

Преобразует представление диапазона числа в формате, зависяющем от языка и региональных параметров, в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] short % result);

public static bool TryParse(ReadOnlySpan<char> s, out short result);

static member TryParse : ReadOnlySpan<char> * int16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Short) As Boolean

Параметры

s

ReadOnlySpan<Char>

Диапазон, содержащий символы, представляющие число для преобразования.

result

Int16

При возврате этого метода содержит 16-разрядное целочисленное значение со знаком, эквивалентное числу, содержаемого в s, если преобразование выполнено успешно, или ноль, если преобразование завершилось ошибкой. Преобразование завершается ошибкой, если s параметр равен null или Empty представляет число меньше, чем Int16.MinValue или больше Int16.MaxValue. Этот параметр передается неинициализирован; любое исходное result значение будет перезаписан.

Возвращаемое значение

Boolean

true Значение , если s оно было успешно преобразовано; в противном случае false.

TryParse(String, Int16)

Исходный код:

Int16.cs

Преобразует строковое представление числа в 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] short % result);

public static bool TryParse(string? s, out short result);

static member TryParse : string * int16 -> bool

Public Shared Function TryParse (s As String, ByRef result As Short) As Boolean

Параметры

s

String

Строка, содержащая число для преобразования.

result

Int16

При возврате этого метода содержит 16-разрядное целочисленное значение со знаком, эквивалентное числу, содержаемого в s, если преобразование выполнено успешно, или ноль, если преобразование завершилось ошибкой. Преобразование завершается ошибкой, если s параметр имеет null или Emptyне соответствует правильному формату, или представляет число меньше, чем Int16.MinValue или больше, чем Int16.MaxValue. Этот параметр передается неинициализирован; любое исходное result значение будет перезаписан.

Возвращаемое значение

Boolean

true Значение , если s оно было успешно преобразовано; в противном случае false.

Примеры

В следующем примере вызывается Int16.TryParse(String, Int16) метод с несколькими разными строковыми значениями.

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("16051");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      short number;
      bool result = Int16.TryParse(value, out number);
      if (result)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      else
      {
         if (value == null) value = "";
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '16051' to 16051.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100)' failed.
//       Attempted conversion of '01FA' failed.

open System

let tryToParse (value: string) =
    match Int16.TryParse value with
    | true, number -> printfn "Converted '{value}' to {number}."
    | _ ->
        let value = if isNull value then "" else value
        printfn $"Attempted conversion of '{value}' failed."

tryToParse null
tryToParse "16051"
tryToParse "9432.0"
tryToParse "16,667"
tryToParse "   -322   "
tryToParse "+4302"
tryToParse "(100);"
tryToParse "01FA"

// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '16051' to 16051.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100)' failed.
//       Attempted conversion of '01FA' failed.

Module StringParsing
   Public Sub Main()
      TryToParse(Nothing)
      TryToParse("16051")
      TryToParse("9432.0")
      TryToParse("16,667")
      TryToParse("   -322   ")
      TryToParse("+4302")
      TryToParse("(100)")
      TryToParse("01FA")
      
   End Sub
   
   Private Sub TryToParse(value As String)
      Dim number As Int16
      Dim result As Boolean = Int16.TryParse(value, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Else
         If value Is Nothing Then value = "" 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value)
      End If     
   End Sub
End Module
' The example displays the following output to the console:
'       Attempted conversion of '' failed.
'       Converted '16051' to 16051.
'       Attempted conversion of '9432.0' failed.
'       Attempted conversion of '16,667' failed.
'       Converted '   -322   ' to -322.
'       Converted '+4302' to 4302.
'       Attempted conversion of '(100)' failed.
'       Attempted conversion of '01FA' failed.

Ниже приведены некоторые строки, которые TryParse(String, Int16) метод не может преобразовать в этом примере:

• "9432.0". Преобразование завершается ошибкой, так как строка не может содержать десятичный разделитель; он должен содержать только целочисленные цифры.

• "16,667". Преобразование завершается ошибкой, так как строка не может содержать разделители групп; он должен содержать только целочисленные цифры.

• "(100)". Преобразование завершается ошибкой, так как строка не может содержать отрицательный знак, отличный от знака, определенного текущим языком и свойствами языка и NumberFormatInfo.NumberNegativePattern региональных NumberFormatInfo.NegativeSign параметров.

• "01FA". Преобразование завершается ошибкой, так как строка не может содержать шестнадцатеричные цифры; Он должен содержать только десятичные цифры.

Комментарии

Метод Int16.TryParse(String, Int16) отличается от Int16.Parse(String) метода, возвращая логическое значение, указывающее, выполнена ли операция синтаксического анализа вместо возврата проанализированного Int16 значения. Это устраняет необходимость использовать обработку исключений для FormatException тестирования в случае s , которое является недопустимым и не может быть успешно проанализировано.

Параметр s должен быть строковым представлением числа в форме:

[ws] [знак]цифры[ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Элемент	Описание
ws	Необязательный пробел.
знак	Необязательный знак.
Цифр	Последовательность цифр от 0 до 9.

Параметр s интерпретируется с помощью NumberStyles.Integer стиля. Помимо десятичных цифр разрешены только начальные и конечные пробелы вместе с начальным знаком. Чтобы явно определить элементы стиля вместе с сведениями о форматировании, зависящими от языка и региональных параметров, которые могут присутствовать в sметоде Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) .

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo , инициализированном для текущего языка и региональных параметров системы. Дополнительные сведения см. в разделе CurrentInfo.

Эта перегрузка TryParse метода интерпретирует все цифры в параметре s как десятичные цифры. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите перегрузку Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) .

См. также раздел

• Parse(String)
• ToString()
• Анализ числовых строк в .NET
• Пример: программа форматирования WinForms для .NET Core (C#)
• Пример: программа форматирования WinForms для .NET Core (Visual Basic)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16)

Исходный код:

Int16.cs

Пытается проанализировать диапазон символов в значение.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = ISpanParsable<short>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out short result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s

ReadOnlySpan<Char>

Диапазон символов для синтаксического анализа.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от sязыка и региональных параметров.

result

Int16

При возврате этого метода содержит результат успешного анализа sили неопределенное значение при сбое.

Возвращаемое значение

Boolean

true Значение , если s был успешно проанализирован; в противном случае false.

TryParse(String, IFormatProvider, Int16)

Исходный код:

Int16.cs

Пытается проанализировать строку в значение.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IParsable<short>::TryParse;

public static bool TryParse(string? s, IFormatProvider? provider, out short result);

static member TryParse : string * IFormatProvider * int16 -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s

String

Строка для синтаксического анализа.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от sязыка и региональных параметров.

result

Int16

При возврате этого метода содержит результат успешного анализа s или неопределенного значения при сбое.

Возвращаемое значение

Boolean

true Значение , если s был успешно проанализирован; в противном случае false.

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16)

Исходный код:

Int16.cs

Пытается проанализировать диапазон символов UTF-8 в значение.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

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

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

utf8Text

ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

style

NumberStyles

Побитовое сочетание стилей чисел, которые могут присутствовать в utf8Text.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от utf8Textязыка и региональных параметров.

result

Int16

При возврате содержит результат успешного анализа utf8Text или неопределенного значения при сбое.

Возвращаемое значение

Boolean

true Значение , если utf8Text был успешно проанализирован; в противном случае false.

TryParse(ReadOnlySpan<Byte>, Int16)

Исходный код:

Int16.cs

Пытается преобразовать диапазон символов UTF-8, содержащий строковое представление числа в его 16-разрядное целое число со знаком.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] short % result);

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out short result);

static member TryParse : ReadOnlySpan<byte> * int16 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Short) As Boolean

Параметры

utf8Text

ReadOnlySpan<Byte>

Диапазон, содержащий символы UTF-8, представляющие число для преобразования.

result

Int16

При возврате этого метода содержит 16-разрядное целое число со знаком, эквивалентное числу, содержаму в utf8Text случае успешного преобразования, или ноль, если преобразование завершилось ошибкой. Этот параметр передается неинициализирован; любое исходное значение, предоставленное в результате, будет перезаписан.

Возвращаемое значение

Boolean

true Значение , если utf8Text оно было успешно преобразовано; в противном случае false.

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

Исходный код:

Int16.cs

Преобразует представление диапазона числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

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

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s

ReadOnlySpan<Char>

Диапазон, содержащий символы, представляющие число для преобразования. Диапазон интерпретируется с помощью стиля, указанного в параметре style.

style

NumberStyles

Побитовое сочетание значений перечисления, указывающее элементы стиля, которые могут присутствовать в s. Обычное значение, которое нужно указать Integer.

provider

IFormatProvider

Объект, предоставляющий сведения sо форматировании с учетом языка и региональных параметров.

result

Int16

При возврате этого метода содержит 16-разрядное целочисленное значение со знаком, эквивалентное числу, содержаемого в s, если преобразование выполнено успешно, или ноль, если преобразование завершилось ошибкой. Преобразование завершается ошибкой, если s параметр имеет null или Emptyне соответствует формату, соответствующему styleформату, или представляет число меньше, чем Int16.MinValue или больше, чем Int16.MaxValue. Этот параметр передается неинициализирован; любое исходное result значение будет перезаписан.

Возвращаемое значение

Boolean

true Значение , если s оно было успешно преобразовано; в противном случае false.

TryParse(String, NumberStyles, IFormatProvider, Int16)

Исходный код:

Int16.cs

Преобразует строковое представление числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком. Возвращаемое значение указывает, выполнено ли преобразование успешно или завершилось сбоем.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;

public static bool TryParse(string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);

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

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s

String

Строка, содержащая число для преобразования. Строка интерпретируется с помощью стиля, заданного .style

style

NumberStyles

Побитовое сочетание значений перечисления, указывающее элементы стиля, которые могут присутствовать в s. Обычное значение, которое нужно указать Integer.

provider

IFormatProvider

Объект, предоставляющий сведения sо форматировании с учетом языка и региональных параметров.

result

Int16

При возврате этого метода содержит 16-разрядное целочисленное значение со знаком, эквивалентное числу, содержаемого в s, если преобразование выполнено успешно, или ноль, если преобразование завершилось ошибкой. Преобразование завершается ошибкой, если s параметр имеет null или Emptyне соответствует формату, соответствующему styleформату, или представляет число меньше, чем Int16.MinValue или больше, чем Int16.MaxValue. Этот параметр передается неинициализирован; любое исходное result значение будет перезаписан.

Возвращаемое значение

Boolean

true Значение , если s оно было успешно преобразовано; в противном случае false.

Исключения

ArgumentException

style значение не является значением NumberStyles .

-или-

styleне является сочетанием значений и HexNumber значенийAllowHexSpecifier.

Примеры

В следующем примере вызывается Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) метод с несколькими разными строковыми значениями.

using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;

      numericString = "10677";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);

      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593";
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);

      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles);

      numericString = "12E03";
      CallTryParse(numericString, styles);

      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);

      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      short number;
      bool result = Int16.TryParse(stringToConvert, styles,
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
      else
         Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
   }
}
// The example displays the following output to the console:
//       Converted '10677' to 10677.
//       Attempted conversion of '-30677' failed.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to -32575.
//       Attempted conversion of '0x80C1' failed.

open System
open System.Globalization

let callTryParse (stringToConvert: string) (styles: NumberStyles) =
    match Int16.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."

[<EntryPoint>]
let main _ =
    let numericString = "10677"
    let styles = NumberStyles.Integer
    callTryParse numericString styles

    let numericString = "-30677"
    let styles = NumberStyles.None
    callTryParse numericString styles

    let numericString = "10345.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "10345.72";
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "22,593"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowThousands
    callTryParse numericString styles

    let numericString = "12E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles

    let numericString = "12E03"
    callTryParse numericString styles

    let numericString = "80c1"
    callTryParse numericString NumberStyles.HexNumber

    let numericString = "0x80C1"
    callTryParse numericString NumberStyles.HexNumber

    0


// The example displays the following output to the console:
//       Converted '10677' to 10677.
//       Attempted conversion of '-30677' failed.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to -32575.
//       Attempted conversion of '0x80C1' failed.

Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10677"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Short
      Dim result As Boolean = Int16.TryParse(stringToConvert, styles, _
                                             CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '10677' to 10677.
'       Attempted conversion of '-30677' failed.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to -32575.
'       Attempted conversion of '0x80C1' failed.

Комментарии

Метод Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) отличается от Int16.Parse(String, NumberStyles, IFormatProvider) метода, возвращая логическое значение, указывающее, выполнена ли операция синтаксического анализа вместо возврата проанализированного Int16 значения. Это устраняет необходимость использовать обработку исключений для FormatException тестирования в случае s , которое является недопустимым и не может быть успешно проанализировано.

Параметр style определяет элементы стиля (например, пробелы или положительный или отрицательный знак), которые разрешены в s параметре для успешной операции синтаксического анализа. Это должно быть сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения стиля s параметр может включать следующие элементы:

[ws] [$] [знак] [цифры,]цифры[.fractional_digits][знак][знак][цифры][ws]

Или, если параметр style включает NumberStyles.AllowHexSpecifier:

[ws]hexdigits[ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Элемент	Описание
ws	Необязательный пробел. Пробел может отображаться в начале s , если style он содержит NumberStyles.AllowLeadingWhite флаг, или в конце s , если style этот флаг включен NumberStyles.AllowTrailingWhite .
$	Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется CurrencyPositivePattern свойством NumberFormatInfo объекта, возвращаемого GetFormat методом provider параметра. Символ валюты может отображаться в s том случае, если style он включает NumberStyles.AllowCurrencySymbol флаг.
знак	Необязательный знак.
Цифр	Последовательность цифр от 0 до 9.
,	Разделитель тысяч, зависящих от языка и региональных параметров. Разделитель тысяч языка и региональных параметров, указанный параметром provider , может отображаться в s том случае, если style он содержит NumberStyles.AllowThousands флаг.
.	Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой языка и региональных параметров, указанный в provider нем, может отображаться в s том случае, если style он NumberStyles.AllowDecimalPoint содержит флаг.
fractional_digits	Одно или несколько вхождений цифры 0. Дробные цифры могут отображаться только в s том случае, если style он содержит NumberStyles.AllowDecimalPoint флаг.
e	Символ e или E, указывающий, что значение представлено в экспоненциальной нотации. Параметр s может представлять число в экспоненциальной нотации, если style он включает NumberStyles.AllowExponent флаг.
hexdigits	Последовательность шестнадцатеричных цифр от 0 до f или 0 до F.

Заметка

Все завершающие символы s NUL (U+0000) игнорируются операцией синтаксического анализа независимо от значения аргумента style .

Строка с десятичными цифрами (которая соответствует флагу NumberStyles.None ) всегда анализируется успешно. Большинство остальных NumberStyles элементов управления элементами управления, которые могут быть, но не обязательно должны присутствовать в этой входной строке. В следующей таблице показано, как отдельные NumberStyles элементы влияют на элементы, которые могут присутствовать в s.

Не составные значения NumberStyles	Элементы, разрешенные в s в дополнение к цифрам
NumberStyles.None	Только десятичные цифры.
NumberStyles.AllowDecimalPoint	Элементы . и fractional_digits . Однако fractional_digits должны состоять только из одной или нескольких цифр или возвращаемых falseметодом.
NumberStyles.AllowExponent	Параметр s также может использовать экспоненциальную нотацию. Если s представляет число в экспоненциальной нотации, оно должно представлять целое число в диапазоне Int16 типа данных без ненулевых дробных компонентов.
NumberStyles.AllowLeadingWhite	Элемент ws в начале s.
NumberStyles.AllowTrailingWhite	Элемент ws в конце s.
NumberStyles.AllowLeadingSign	Знак может появиться перед цифрами.
NumberStyles.AllowTrailingSign	Знак может появиться после цифр.
NumberStyles.AllowParentheses	Элемент sign в виде скобки, включающей числовое значение.
NumberStyles.AllowThousands	Элемент ,
NumberStyles.AllowCurrencySymbol	Элемент $ .
NumberStyles.Currency	Все элементы. Параметр s не может представлять шестнадцатеричное число или число в экспоненциальной нотации.
NumberStyles.Float	Элемент ws в начале или конце s, знак в начале sи символ . Параметр s также может использовать экспоненциальную нотацию.
NumberStyles.Number	Ws, знак, тысячи разделителей (,), а также элементы десятичной запятой (.).
NumberStyles.Any	Все стили, кроме s не может представлять шестнадцатеричное число.

NumberStyles.AllowHexSpecifier Если флаг используется, s должен быть шестнадцатеричным значением без префикса. Например, синтаксический анализ 9AF3 выполняется успешно, но "0x9AF3" не выполняется. Единственные другие флаги, которые могут присутствовать в styleNumberStyles.AllowLeadingWhite них, и NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет составной стиль, NumberStyles.HexNumberкоторый включает оба флага пробела.)

Параметр provider представляет собой IFormatProvider реализацию, например CultureInfo объект или NumberFormatInfo объект, метод которого GetFormat возвращает NumberFormatInfo объект. Объект NumberFormatInfo предоставляет сведения о формате sязыка и региональных параметров. В provider противном nullNumberFormatInfo случае используется объект для текущего языка и региональных параметров.

См. также раздел

• Parse
• NumberStyles
• ToString()
• Анализ числовых строк в .NET