Version.Parse Método

Definição

Namespace:: System

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assemblies:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

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.

Sobrecargas

Nome	Description
Parse(ReadOnlySpan<Byte>)	Converte o intervalo somente leitura especificado de caracteres UTF-8 que representa um número de versão em um objeto Version equivalente.
Parse(ReadOnlySpan<Char>)	Converte o intervalo de caracteres somente leitura especificado que representa um número de versão em um objeto equivalente Version .
Parse(String)	Converte a representação de cadeia de caracteres de um número de versão em um objeto equivalente Version .

Parse(ReadOnlySpan<Byte>)

Origem:: Version.cs

Origem:: Version.cs

Converte o intervalo somente leitura especificado de caracteres UTF-8 que representa um número de versão em um objeto Version equivalente.

public:
 static Version ^ Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Version Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Version

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Version

Parâmetros

utf8Text: ReadOnlySpan<Byte>

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

Retornos

Version

Um objeto equivalente ao número de versão especificado no utf8Text parâmetro.

Exceções

ArgumentException

utf8Text tem menos de dois ou mais de quatro componentes de versão.

ArgumentOutOfRangeException

Pelo menos um componente é utf8Text menor que zero.

FormatException

Pelo menos um componente não utf8Text é um inteiro.

OverflowException

Pelo menos um componente utf8Text representa um número maior que MaxValue.

Aplica-se a

Parse(ReadOnlySpan<Char>)

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Converte o intervalo de caracteres somente leitura especificado que representa um número de versão em um objeto equivalente Version .

public:
 static Version ^ Parse(ReadOnlySpan<char> input);

public static Version Parse(ReadOnlySpan<char> input);

static member Parse : ReadOnlySpan<char> -> Version

Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Version

Parâmetros

input: ReadOnlySpan<Char>

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

Retornos

Version

Um objeto equivalente ao número de versão especificado no input parâmetro.

Exceções

ArgumentException

input tem menos de dois ou mais de quatro componentes de versão.

ArgumentOutOfRangeException

Pelo menos um componente é input menor que zero.

FormatException

Pelo menos um componente não input é um inteiro.

OverflowException

Pelo menos um componente input representa um número maior que Int32.MaxValue.

Comentários

O input parâmetro deve ter o 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 na ordem especificada e devem ser separados por períodos.

Aplica-se a

Parse(String)

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Origem:: Version.cs

Converte a representação de cadeia de caracteres de um número de versão em um objeto equivalente Version .

public:
 static Version ^ Parse(System::String ^ input);

public static Version Parse(string input);

static member Parse : string -> Version

Public Shared Function Parse (input As String) As Version

Parâmetros

input: String

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

Retornos

Version

Um objeto equivalente ao número de versão especificado no input parâmetro.

Exceções

ArgumentNullException

input é null.

ArgumentException

input tem menos de dois ou mais de quatro componentes de versão.

ArgumentOutOfRangeException

Pelo menos um componente é input menor que zero.

FormatException

Pelo menos um componente não input é um inteiro.

OverflowException

Pelo menos um componente input representa um número maior que Int32.MaxValue.

Exemplos

O exemplo a seguir usa o Parse 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)
   {
      try {
         Version ver = Version.Parse(input);
         Console.WriteLine("Converted '{0} to {1}.", input, ver);
      }
      catch (ArgumentNullException) {
         Console.WriteLine("Error: String to be parsed is null.");
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("Error: Negative value in '{0}'.", input);
      }
      catch (ArgumentException) {
         Console.WriteLine("Error: Bad number of components in '{0}'.", 
                           input);
      }
      catch (FormatException) {
         Console.WriteLine("Error: Non-integer value in '{0}'.", input);
      }
      catch (OverflowException) {   
         Console.WriteLine("Error: Number out of range in '{0}'.", input);                  
      }   
   }
}
// The example displays the following output:
//       Converted '4.0 to 4.0.
//       Error: Non-integer value in '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Error: Bad number of components in '1.1.2.0702.119'.
//       Error: Number out of range in '1.3.5.2150000000'.

open System

let parseVersion (input: string) =
    try
        let ver = Version.Parse input
        printfn $"Converted '{input} to {ver}."
    with
    | :? ArgumentNullException ->
        printfn "Error: String to be parsed is null."
    | :? ArgumentOutOfRangeException ->
        printfn $"Error: Negative value in '{input}'."
    | :? ArgumentException ->
        printfn $"Error: Bad number of components in '{input}'."
    | :? FormatException ->
        printfn $"Error: Non-integer value in '{input}'."
    | :? OverflowException ->
        printfn $"Error: Number out of range in '{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.
//       Error: Non-integer value in '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Error: Bad number of components in '1.1.2.0702.119'.
//       Error: Number out of range in '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)
      Try
         Dim ver As Version = Version.Parse(input)
         Console.WriteLine("Converted '{0} to {1}.", input, ver)
      Catch e As ArgumentNullException
         Console.WriteLine("Error: String to be parsed is null.")
      Catch e As ArgumentOutOfRangeException
         Console.WriteLine("Error: Negative value in '{0}'.", input)
      Catch e As ArgumentException
         Console.WriteLine("Error: Bad number of components in '{0}'.", 
                           input)
      Catch e As FormatException
         Console.WriteLine("Error: Non-integer value in '{0}'.", input)
      Catch e As OverflowException   
         Console.WriteLine("Error: Number out of range in '{0}'.", input)                  
      End Try   
   End Sub
End Module
' The example displays the following output:
'       Converted '4.0 to 4.0.
'       Error: Non-integer value in '4.0.'.
'       Converted '1.1.2 to 1.1.2.
'       Converted '1.1.2.01702 to 1.1.2.1702.
'       Error: Bad number of components in '1.1.2.0702.119'.
'       Error: Number out of range in '1.3.5.2150000000'.

Comentários

O input parâmetro deve ter o seguinte formato:

major.minor[.build[.revision]]

Importante

Como a representação de cadeia de caracteres de um número de versão deve estar em conformidade com um padrão reconhecido, os aplicativos sempre devem usar o tratamento de exceção ao chamar o Parse método para analisar a entrada do usuário. Como alternativa, você pode chamar o TryParse método para analisar a representação de cadeia de caracteres de um número de versão e retornar um valor que indica se a operação de análise foi bem-sucedida.

O Parse método é um método de conveniência; é equivalente a chamar o Version(String) construtor.

Confira também

Aplica-se a

Comentários

Esta página foi útil?