Version.Parse Método

Referencia

Definición

Espacio de nombres:: System

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: mscorlib.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

Parse(ReadOnlySpan<Char>)	Convierte el intervalo de caracteres de solo lectura especificado que representa un número de versión en un objeto Version equivalente.
Parse(String)	Convierte la representación de cadena de un número de versión en un objeto Version equivalente.

Parse(ReadOnlySpan<Char>)

Source:: Version.cs

Source:: Version.cs

Source:: Version.cs

Convierte el intervalo de caracteres de solo lectura especificado que representa un número de versión en un objeto Version equivalente.

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>

Intervalo de caracteres de solo lectura que contiene un número de versión que se va a convertir.

Devoluciones

Version

Objeto equivalente al número de versión especificado en el parámetro input.

Excepciones

ArgumentException

input tiene menos de dos componentes de versión o más de cuatro.

ArgumentOutOfRangeException

Al menos un componente de input es menor que cero.

FormatException

Al menos un componente de input no es un entero.

OverflowException

Al menos un componente de input representa un número mayor que Int32.MaxValue.

Comentarios

El input parámetro debe tener el formato siguiente:

major.minor[.build[.revision]]

donde major, minor, buildy revision son las representaciones de cadena de los cuatro componentes del número de versión: número de versión principal, número de versión secundaria, número de compilación y número de revisión, respectivamente. Los componentes opcionales se muestran entre corchetes ([ y ]). Los componentes deben aparecer en el orden especificado y deben estar separados por puntos.

Se aplica a

Parse(String)

Source:: Version.cs

Source:: Version.cs

Source:: Version.cs

Convierte la representación de cadena de un número de versión en un objeto Version equivalente.

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

Cadena que contiene un número de versión que se va a convertir.

Devoluciones

Version

Objeto equivalente al número de versión especificado en el parámetro input.

Excepciones

ArgumentNullException

input es null.

ArgumentException

input tiene menos de dos componentes de versión o más de cuatro.

ArgumentOutOfRangeException

Al menos un componente de input es menor que cero.

FormatException

Al menos un componente de input no es un entero.

OverflowException

Al menos un componente de input representa un número mayor que Int32.MaxValue.

Ejemplos

En el ejemplo siguiente se usa el Parse método para analizar una serie de cadenas que contienen información de versión.

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

Comentarios

El input parámetro debe tener el formato siguiente:

major.minor[.build[.revision]]

Importante

Dado que la representación de cadena de un número de versión debe ajustarse a un patrón reconocido, las aplicaciones siempre deben usar el control de excepciones al llamar al método para analizar la entrada del Parse usuario. Como alternativa, puede llamar al TryParse método para analizar la representación de cadena de un número de versión y devolver un valor que indica si la operación de análisis se realizó correctamente.

El Parse método es un método de conveniencia; equivale a llamar al Version(String) constructor .

Consulte también

Se aplica a

Version.Parse Método

Definición

Sobrecargas

Parse(ReadOnlySpan<Char>)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Parse(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios

Recursos adicionales