Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Version.Parse (String)

 

Publicado: octubre de 2016

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

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public static Version Parse(
	string input
)

Parámetros

input
Type: System.String

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

Valor devuelto

Type: System.Version

Un objeto que es equivalente al número de versión especificado en el input parámetro.

Exception Condition
ArgumentNullException

El valor de input es null.

ArgumentException

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

ArgumentOutOfRangeException

Al menos un componente en input es menor que cero.

FormatException

Al menos un componente en input no es un entero.

OverflowException

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

El input parámetro debe tener el formato siguiente:


major.minor[.build[.revision]]

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

System_CAPS_importantImportante

Dado que la representación de cadena de un número de versión debe cumplir un modelo reconocido, las aplicaciones siempre deben usar control de excepciones al llamar a la Parse método para analizar la entrada del usuario. Como alternativa, puede llamar a la 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 útil; es equivalente a llamar a la Version(String) constructor.

En el ejemplo siguiente se usa el Parse método para analizar un número 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'.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 4.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 4.0
Windows Phone Silverlight
Disponible desde 7.1
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: