Version.Parse Método

Definição

Espaço de Nomes:: System

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

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

Parse(ReadOnlySpan<Byte>)

Origem:: Version.cs

Origem:: Version.cs

Converte o espaço especificado de apenas leitura dos caracteres UTF-8 que representa um número de versão para 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 espaço de apenas leitura de caracteres UTF-8 que contém um número de versão a converter.

Devoluções

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 em utf8Text é inferior a zero.

FormatException

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

OverflowException

Pelo menos um componente em 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 espaço de caracteres especificado em somente leitura que representa um número de versão para 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 de caracteres apenas leitura que contém um número de versão a converter.

Devoluções

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 em input é inferior a zero.

FormatException

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

OverflowException

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

Observações

O input parâmetro deve ter o 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 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 da cadeia de um número de versão num 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 que contém um número de versão para converter.

Devoluções

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 em input é inferior a zero.

FormatException

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

OverflowException

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

Exemplos

O exemplo seguinte utiliza o Parse 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)
   {
      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'.

Observações

O input parâmetro deve ter o seguinte formato:

major.minor[.build[.revision]]

Importante

Como a representação da cadeia de um número de versão deve conformar-se a um padrão reconhecido, as aplicações devem sempre usar o tratamento de exceções ao chamar o Parse método para analisar a entrada do utilizador. Alternativamente, pode chamar o TryParse método para analisar a representação da cadeia de um número de versão e devolver um valor que indique 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.

Ver também

Aplica-se a

Comentários

Esta página foi útil?