Version.TryParse Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Sobrecargas

TryParse(String, Version)

Tenta converter a representação de cadeia de caracteres um número de versão em um objeto Version equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
TryParse(ReadOnlySpan<Char>, Version)

Tenta converter o intervalo de caracteres somente leitura especificado que representa um número de versão em um objeto Version equivalente e retorna um valor que indica se a conversão foi bem-sucedida.

TryParse(String, Version)

Origem:
Version.cs
Origem:
Version.cs
Origem:
Version.cs

Tenta converter a representação de cadeia de caracteres um número de versão em um objeto Version equivalente e retorna um valor que indica se a conversão foi bem-sucedida.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Version ^ % result);
public static bool TryParse (string input, 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

Parâmetros

input
String

Uma cadeia de caracteres que contém um número de versão a ser convertido.

result
Version

Quando esse método for retornado, conterá o equivalente Version do número contido em input se a conversão for bem-sucedida. Se input for null, Empty ou se a conversão falhar, result será null quando o método retornar.

Retornos

Boolean

true caso o parâmetro input tenha sido convertido com êxito; do contrário, false.

Exemplos

O exemplo a seguir usa o TryParse método para analisar várias cadeias de caracteres que contêm informações de versão.

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'.

Comentários

O TryParse método é semelhante ao Parse método , exceto que ele não gera uma exceção se a conversão falhar. Em vez disso, retornará false se input for null, tiver menos de dois ou mais de quatro componentes, tiver pelo menos um componente que não seja um inteiro, tiver pelo menos um componente menor que zero ou tiver pelo menos um componente maior que Int32.MaxValue.

Para que a operação de análise seja bem-sucedida, o input parâmetro deve estar no seguinte formato:

major.minor[.build[.revision]]

em que major, minor, builde revision são as representações de cadeia de caracteres dos quatro componentes do número de versão: número de versão principal, número de versão secundária, número de build e número de revisão, respectivamente. Os componentes opcionais são mostrados entre colchetes ([ e ]). Os componentes devem aparecer na ordem e devem ser separados por períodos.

Confira também

Aplica-se a

TryParse(ReadOnlySpan<Char>, Version)

Origem:
Version.cs
Origem:
Version.cs
Origem:
Version.cs

Tenta converter o intervalo de caracteres somente leitura especificado que representa um número de versão em um objeto Version equivalente e retorna um valor que indica se a conversão foi bem-sucedida.

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Version ^ % result);
public static bool TryParse (ReadOnlySpan<char> input, 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

Parâmetros

input
ReadOnlySpan<Char>

Um intervalo somente leitura de caracteres que contém um número de versão a ser convertido.

result
Version

Quando esse método for retornado, conterá o equivalente Version do número contido em input se a conversão for bem-sucedida. Se input for null, Empty ou se a conversão falhar, result será null quando o método retornar.

Retornos

Boolean

true caso o parâmetro input tenha sido convertido com êxito; do contrário, false.

Comentários

O TryParse método é semelhante ao Parse método , exceto que ele não gera uma exceção se a conversão falhar. Em vez disso, retornará false se input for null, tiver menos de dois ou mais de quatro componentes, tiver pelo menos um componente que não seja um inteiro, tiver pelo menos um componente menor que zero ou tiver pelo menos um componente maior que Int32.MaxValue.

Para que a operação de análise seja bem-sucedida, o input parâmetro deve estar no seguinte formato:

major.minor[.build[.revision]]

em que major, minor, builde revision são as representações de cadeia de caracteres dos quatro componentes do número de versão: número de versão principal, número de versão secundária, número de build e número de revisão, respectivamente. Os componentes opcionais são mostrados entre colchetes ([ e ]). Os componentes devem aparecer na ordem e devem ser separados por períodos.

Aplica-se a