Version.TryParse Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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. |
- 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
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
, build
e 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 |
- 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
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
, build
e 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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: