Version.TryParse Método

Definição

Sobrecargas

Nome Description
TryParse(ReadOnlySpan<Char>, Version)

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

TryParse(String, Version)

Tenta converter a representação de cadeia de caracteres de um número de versão em um objeto equivalente Version 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 equivalente Version 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);
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 é retornado, contém o Version equivalente do número contido, inputse a conversão tiver sido bem-sucedida. Se input for null, Emptyou se a conversão falhar, result será null quando o método retornar.

Retornos

true se o input parâmetro tiver sido convertido com êxito; caso 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, retorna false se input for null, tem menos de dois ou mais de quatro componentes, tem pelo menos um componente que não é um inteiro, tem pelo menos um componente menor que zero ou tem 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]]

onde major, minore buildrevision 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. Componentes opcionais são mostrados em colchetes ([ e ]). Os componentes devem aparecer em ordem e devem ser separados por períodos.

Aplica-se a

TryParse(String, Version)

Tenta converter a representação de cadeia de caracteres de um número de versão em um objeto equivalente Version 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);
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 é retornado, contém o Version equivalente do número contido, inputse a conversão tiver sido bem-sucedida. Se input for null, Emptyou se a conversão falhar, result será null quando o método retornar.

Retornos

true se o input parâmetro tiver sido convertido com êxito; caso 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, retorna false se input for null, tem menos de dois ou mais de quatro componentes, tem pelo menos um componente que não é um inteiro, tem pelo menos um componente menor que zero ou tem 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]]

onde major, minore buildrevision 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. Componentes opcionais são mostrados em colchetes ([ e ]). Os componentes devem aparecer em ordem e devem ser separados por períodos.

Confira também

Aplica-se a