Version.TryParse Método

Definição

Espaço de Nomes:
System
Assemblagem:
netstandard.dll
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.dll

Sobrecargas

Name Description
TryParse(ReadOnlySpan<Char>, Version)

Tenta converter o intervalo de apenas leitura especificado de caracteres que representam um número de versão para um objeto equivalente Version , e devolve um valor que indica se a conversão foi bem-sucedida.
TryParse(String, Version)

Tenta converter a representação em cadeia de um número de versão para um objeto equivalente Version e devolve um valor que indica se a conversão teve sucesso.

TryParse(ReadOnlySpan<Char>, Version)

Tenta converter o intervalo de apenas leitura especificado de caracteres que representam um número de versão para um objeto equivalente Version , e devolve 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 de caracteres apenas leitura que contém um número de versão a converter.

result
Version

Quando este método retorna, contém o Version equivalente ao número que está contido em input, se a conversão tiver sido bem-sucedida. Se input for null, Empty, ou se a conversão falhar, result é null quando o método retorna.

Devoluções

Boolean

true se o input parâmetro foi convertido com sucesso; caso contrário, false.

Observações

O TryParse método é semelhante ao Parse método, exceto que não lança uma exceção se a conversão falhar. Em vez disso, devolve 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, tenha pelo menos um componente menor que zero, ou tenha pelo menos um componente maior que Int32.MaxValue.

Para que a operação de análise sintática tenha sucesso, o input parâmetro deve estar no seguinte formato:

major.minor[.build[.revision]]

onde major, minor, build, e revision são as representações em cadeia dos quatro componentes do número de versão: número de versão principal, número de versão menor, número de compilação e número de revisão, respetivamente. Os componentes opcionais são mostrados entre parênteses quadrados ([ e ]). Os componentes devem aparecer por ordem e devem ser separados por períodos.

Aplica-se a

TryParse(String, Version)

Tenta converter a representação em cadeia de um número de versão para um objeto equivalente Version e devolve um valor que indica se a conversão teve sucesso.

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 que contém um número de versão para converter.

result
Version

Quando este método retorna, contém o Version equivalente ao número que está contido em input, se a conversão tiver sido bem-sucedida. Se input for null, Empty, ou se a conversão falhar, result é null quando o método retorna.

Devoluções

Boolean

true se o input parâmetro foi convertido com sucesso; caso contrário, false.

Exemplos

O exemplo seguinte utiliza o TryParse método para analisar várias cadeias que contêm informação 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'.

Observações

O TryParse método é semelhante ao Parse método, exceto que não lança uma exceção se a conversão falhar. Em vez disso, devolve 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, tenha pelo menos um componente menor que zero, ou tenha pelo menos um componente maior que Int32.MaxValue.

Para que a operação de análise sintática tenha sucesso, o input parâmetro deve estar no seguinte formato:

major.minor[.build[.revision]]

onde major, minor, build, e revision são as representações em cadeia dos quatro componentes do número de versão: número de versão principal, número de versão menor, número de compilação e número de revisão, respetivamente. Os componentes opcionais são mostrados entre parênteses quadrados ([ e ]). Os componentes devem aparecer por ordem e devem ser separados por períodos.

Ver também

Aplica-se a