Ler em inglês

Compartilhar via


Version.TryParse Método

Definição

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 (string input, out Version result);
public static bool TryParse (string? input, out Version? result);

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

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

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

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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, out Version? result);
public static bool TryParse (ReadOnlySpan<char> input, out Version result);

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

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

.NET 9 e outras versões
Produto Versões
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1