Version.TryParse Метод

Определение

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

System

Сборка:

System.Runtime.dll

Перегрузки

TryParse(String, Version)	Предпринимает попытку преобразования строкового представления номера версии в эквивалентный объект Version и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.
TryParse(ReadOnlySpan<Char>, Version)	Предпринимает попытку преобразования указанного диапазона символов только для чтения, представляющего номер версии, в эквивалентный объект Version и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.

TryParse(String, Version)

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

Version.cs

Предпринимает попытку преобразования строкового представления номера версии в эквивалентный объект Version и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.

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

public static bool TryParse (string? input, out Version? result);

static member TryParse : string * Version -> bool

Public Shared Function TryParse (input As String, ByRef result As Version) As Boolean

Параметры

input

String

Строка, содержащая преобразуемый номер версии.

result

Version

После выполнения этого метода содержит эквивалент типа Version числа, содержащегося в параметре input, если преобразование выполнено успешно. Если значением параметра input является null или Empty или произошел сбой преобразования, метод возвращает null в параметре result.

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

Boolean

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

Примеры

В следующем примере метод используется TryParse для анализа ряда строк, содержащих сведения о версии.

using System;

public class Example
{
   public static void Main()
   {
      string input = "4.0";
      ParseVersion(input);
      
      input = "4.0.";
      ParseVersion(input);
      
      input = "1.1.2";
      ParseVersion(input);
      
      input = "1.1.2.01702";
      ParseVersion(input);
      
      input = "1.1.2.0702.119";
      ParseVersion(input);
      
      input =  "1.3.5.2150000000";
      ParseVersion(input);
   }
   
   private static void ParseVersion(string input)
   {
      Version ver = null;
      if (Version.TryParse(input, out ver))
         Console.WriteLine("Converted '{0} to {1}.", input, ver);
      else
         Console.WriteLine("Unable to determine the version from '{0}'.",
                           input);
   }
}
// The example displays the following output:
//       Converted '4.0 to 4.0.
//       Unable to determine the version from '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Unable to determine the version from '1.1.2.0702.119'.
//       Unable to determine the version from '1.3.5.2150000000'.

open System

let parseVersion (input: string) =
    match Version.TryParse input with
    | true, ver ->
        printfn $"Converted '{input} to {ver}."
    | _ ->
        printfn $"Unable to determine the version from '{input}'."

[<EntryPoint>]
let main _ =
    let input = "4.0"
    parseVersion input

    let input = "4.0."
    parseVersion input

    let input = "1.1.2"
    parseVersion input

    let input = "1.1.2.01702"
    parseVersion input

    let input = "1.1.2.0702.119"
    parseVersion input

    let input =  "1.3.5.2150000000"
    parseVersion input
    0
// The example displays the following output:
//       Converted '4.0 to 4.0.
//       Unable to determine the version from '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Unable to determine the version from '1.1.2.0702.119'.
//       Unable to determine the version from '1.3.5.2150000000'.

Module Example
   Public Sub Main()
      Dim input As String = "4.0"
      ParseVersion(input)
      
      input = "4.0."
      ParseVersion(input)
      
      input = "1.1.2"
      ParseVersion(input)
      
      input = "1.1.2.01702"
      ParseVersion(input)
      
      input = "1.1.2.0702.119"
      ParseVersion(input)
      
      input =  "1.3.5.2150000000"
      ParseVersion(input)
   End Sub
   
   Private Sub ParseVersion(input As String)
      Dim ver As Version = Nothing
      If Version.TryParse(input, ver) Then
         Console.WriteLine("Converted '{0} to {1}.", input, ver)
      Else
         Console.WriteLine("Unable to determine the version from '{0}'.",
                           input)
      End If
   End Sub
End Module
' The example displays the following output:
'       Converted '4.0 to 4.0.
'       Unable to determine the version from '4.0.'.
'       Converted '1.1.2 to 1.1.2.
'       Converted '1.1.2.01702 to 1.1.2.1702.
'       Unable to determine the version from '1.1.2.0702.119'.
'       Unable to determine the version from '1.3.5.2150000000'.

Комментарии

Метод TryParse аналогичен методу Parse , за исключением того, что он не создает исключение в случае сбоя преобразования. Вместо этого он возвращает false значение , если input имеет nullзначение , имеет менее двух или более четырех компонентов, имеет по крайней мере один компонент, который не является целым числом, имеет по крайней мере один компонент, который меньше нуля, или имеет по крайней мере один компонент, который больше Int32.MaxValue.

Для успешного input выполнения операции синтаксического анализа параметр должен иметь следующий формат:

major.minor[.build[.revision]]

где major, minor, buildи revision — это строковые представления четырех компонентов номера версии: основной номер версии, дополнительный номер версии, номер сборки и номер редакции соответственно. Необязательные компоненты отображаются в квадратных скобках ([ и ]). Компоненты должны отображаться по порядку и должны быть разделены точками.

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

• Parse(String)
• ToString

TryParse(ReadOnlySpan<Char>, Version)

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

Version.cs

Предпринимает попытку преобразования указанного диапазона символов только для чтения, представляющего номер версии, в эквивалентный объект Version и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.

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

public static bool TryParse (ReadOnlySpan<char> input, out Version? result);

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

Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Version) As Boolean

Параметры

input

ReadOnlySpan<Char>

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

result

Version

После выполнения этого метода содержит эквивалент типа Version числа, содержащегося в параметре input, если преобразование выполнено успешно. Если значением параметра input является null или Empty или произошел сбой преобразования, метод возвращает null в параметре result.

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

Boolean

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

Комментарии

Метод TryParse аналогичен методу Parse , за исключением того, что он не создает исключение в случае сбоя преобразования. Вместо этого он возвращает false значение , если input имеет nullзначение , имеет менее двух или более четырех компонентов, имеет по крайней мере один компонент, который не является целым числом, имеет по крайней мере один компонент, который меньше нуля, или имеет по крайней мере один компонент, который больше Int32.MaxValue.

Для успешного input выполнения операции синтаксического анализа параметр должен иметь следующий формат:

major.minor[.build[.revision]]

где major, minor, buildи revision — это строковые представления четырех компонентов номера версии: основной номер версии, дополнительный номер версии, номер сборки и номер редакции соответственно. Необязательные компоненты отображаются в квадратных скобках ([ и ]). Компоненты должны отображаться по порядку и должны быть разделены точками.