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

Clase Version

 

Publicado: octubre de 2016

Representa el número de versión de un ensamblado, sistema operativo o Common Language Runtime. Esta clase no puede heredarse.

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


[<Sealed>]
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type Version = 
    class
        interface ICloneable
        interface IComparable
        interface IComparable<Version>
        interface IEquatable<Version>
    end

NombreDescripción
System_CAPS_pubmethodVersion()

Inicializa una nueva instancia de la clase Version.

System_CAPS_pubmethodVersion(Int32, Int32)

Inicializa una nueva instancia de la Version clase utilizando los valores principales y secundarias especificados.

System_CAPS_pubmethodVersion(Int32, Int32, Int32)

Inicializa una nueva instancia de la Version especificado principal, secundaria, de clase y valores de compilación.

System_CAPS_pubmethodVersion(Int32, Int32, Int32, Int32)

Inicializa una nueva instancia de la Version clase con especificado principal, secundaria, compilación y números de revisión.

System_CAPS_pubmethodVersion(String)

Inicializa una nueva instancia de la clase Version con la cadena especificada.

NombreDescripción
System_CAPS_pubpropertyBuild

Obtiene el valor del componente de compilación del número de versión actual Version objeto.

System_CAPS_pubpropertyMajor

Obtiene el valor del componente principal del número de versión actual Version objeto.

System_CAPS_pubpropertyMajorRevision

Obtiene los 16 bits superiores del número de revisión.

System_CAPS_pubpropertyMinor

Obtiene el valor del componente secundario del número de versión actual Version objeto.

System_CAPS_pubpropertyMinorRevision

Obtiene los 16 bits inferiores del número de revisión.

System_CAPS_pubpropertyRevision

Obtiene el valor del componente de revisión del número de versión actual Version objeto.

NombreDescripción
System_CAPS_pubmethodClone()

Devuelve un nuevo Version objeto cuyo valor es el mismo que el actual Version objeto.

System_CAPS_pubmethodCompareTo(Object)

Compara actual Version con un objeto especificado y devuelve una indicación de sus valores relativos.

System_CAPS_pubmethodCompareTo(Version)

Compara actual Version objeto en un Version de objetos y devuelve una indicación de sus valores relativos.

System_CAPS_pubmethodEquals(Object)

Devuelve un valor que indica si el actual Version objeto es igual a un objeto especificado.(Invalida Object.Equals(Object)).

System_CAPS_pubmethodEquals(Version)

Devuelve un valor que indica si el actual Version objeto y especificado Version objeto representan el mismo valor.

System_CAPS_pubmethodGetHashCode()

Devuelve un código hash para la actual Version objeto.(Invalida Object.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

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

System_CAPS_pubmethodToString()

Convierte el valor del actual Version objeto equivalente String representación.(Invalida Object.ToString()).

System_CAPS_pubmethodToString(Int32)

Convierte el valor del actual Version objeto equivalente String representación. Un recuento especificado indica el número de componente que se va a devolver.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, Version)

Intenta convertir la representación de cadena de un número de versión en un equivalente Version de objetos y devuelve un valor que indica si la conversión se realizó correctamente.

NombreDescripción
System_CAPS_puboperatorSystem_CAPS_staticEquality(Version, Version)

Determina si dos objetos Version especificados son iguales.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThan(Version, Version)

Determina si el primer especificado Version es mayor que el segundo objeto especificado Version objeto.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThanOrEqual(Version, Version)

Determina si el primer especificado Version objeto es mayor o igual que el segundo especificado Version objeto.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Version, Version)

Determina si dos objetos Version especificados no son iguales.

System_CAPS_puboperatorSystem_CAPS_staticLessThan(Version, Version)

Determina si el primer especificado Version objeto es menor que el segundo especifica Version objeto.

System_CAPS_puboperatorSystem_CAPS_staticLessThanOrEqual(Version, Version)

Determina si el primer especificado Version objeto es menor o igual que el segundo Version objeto.

Números de versión constan de dos a cuatro componentes: principal, secundaria, compilación y revisión. Los componentes principales y secundarias son necesarios; los componentes de compilación y revisión son opcionales, pero el componente de compilación es necesario si se ha definido el componente de revisión. Todos los componentes definidos deben ser enteros mayores o iguales que 0. El formato del número de versión es como sigue (componentes opcionales aparecen entre corchetes ([y]):

major.minor[.build[.revisión]]

Los componentes se usan por convención, como sigue:

  • Principal: los ensamblados con el mismo nombre pero diferentes versiones principales no son intercambiables. Un mayor número de versión podría indicar una gran reelaboración de un producto que no se puede asumir la compatibilidad con versiones anteriores.

  • Secundaria: si el nombre y número de versión principal de dos ensamblados son iguales, pero el número de versión secundaria es diferente, esto indica una mejora significativa con la intención de compatibilidad con versiones anteriores. Este número de versión secundaria más alto puede indicar el lanzamiento de un producto o una nueva versión de totalmente compatible con versiones anteriores de un producto.

  • Generar: una diferencia en el número de compilación representa una recompilación del mismo origen. Números de compilación diferente podrían utilizarse cuando cambia el procesador, plataforma o compilador.

  • Revisión: ensamblados con los mismos números de versión de nombre, principal y secundaria pero con revisiones diferentes están pensados para ser completamente intercambiables. Un mayor número de revisión podría utilizarse en una compilación que corrige una vulnerabilidad de seguridad en un ensamblado anterior.

Las versiones posteriores de un ensamblado que difieran sólo en los números de compilación y revisión se consideran actualizaciones de revisión de la versión anterior.

System_CAPS_importantImportante

El valor de Version propiedades que no asignados explícitamente un valor es indefinido (-1).

A partir de .NET Framework 2.0, el MajorRevision y MinorRevision Propiedades le permiten identificar una versión provisional de la aplicación que, por ejemplo, corrige un problema hasta que pueda lanzar una solución permanente. Además, el sistema operativo Windows NT utiliza el MajorRevision propiedad para codificar el número de service pack.

Normalmente, la Version clase no se utiliza para asignar un número de versión a un ensamblado. En su lugar, la AssemblyVersionAttribute clase se utiliza para definir la versión de un ensamblado, como se muestra en el ejemplo de este tema.

Version objetos con más frecuencia se utilizan para almacenar información de versión sobre algún componente del sistema o la aplicación (por ejemplo, el sistema operativo), common language runtime, el ejecutable de la aplicación actual o un ensamblado determinado. Los ejemplos siguientes muestran algunos de los escenarios más comunes:

  • Recuperar la versión del sistema operativo. En el ejemplo siguiente se usa el OperatingSystem.Version propiedad para recuperar el número de versión del sistema operativo.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
  • Recuperar la versión de common language runtime. En el ejemplo siguiente se usa el Environment.Version propiedad que se va a recuperar la información de versión de common language runtime.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
  • Recuperar la versión de ensamblado de la aplicación actual. En el ejemplo siguiente se usa el Assembly.GetEntryAssembly método para obtener una referencia a un Assembly objeto que representa el ejecutable de la aplicación y, a continuación, recupera su número de versión del ensamblado.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
  • Recuperar la versión de ensamblado del ensamblado actual. En el ejemplo siguiente se usa el Type.Assembly propiedad para obtener una referencia a un Assembly objeto que representa el ensamblado que contiene el punto de entrada de la aplicación y, a continuación, recupera su información de versión.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
  • Recuperar la versión de un ensamblado específico. En el ejemplo siguiente se usa el Assembly.ReflectionOnlyLoadFrom método para obtener una referencia a un Assembly objeto que tiene un nombre de archivo en particular y, a continuación, recupera su información de versión. Tenga en cuenta que también existen otros métodos para crear instancias de un Assembly objeto por el nombre de archivo o por nombre seguro.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
  • Recuperar la versión de publicación de una aplicación ClickOnce. En el ejemplo siguiente se usa el ApplicationDeployment.CurrentVersion propiedad para mostrar la versión de publicación de la aplicación. Tenga en cuenta que su ejecución correcta requiere la identidad de aplicación del ejemplo establecerse. Esto se controla automáticamente mediante el Asistente de publicación de Visual Studio.

    No hay ningún ejemplo de código disponible o este idioma no es compatible.
    System_CAPS_importantImportante

    La versión de publicación de una aplicación para la implementación de ClickOnce es completamente independiente de la versión de ensamblado.

Puede usar el CompareTo método para determinar si un Version objeto es anterior, igual o posterior a un segundo Version objeto. En el ejemplo siguiente se indica que la versión 2.1 es posterior a la versión 2.0.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Dos versiones son iguales, el principal, secundaria, compilación y los números de revisión del primer Version objeto debe ser idéntico a las del segundo Version objeto. Si el número de compilación y revisión de un Version no está definido, el objeto que Version se considera que el objeto es anterior a un Version objeto cuya compilación o el número de revisión es igual a cero. El siguiente ejemplo ilustra esto mediante la comparación de tres Version objetos que tienen sin definir componentes de la versión.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

En el ejemplo siguiente se usa el AssemblyVersionAttribute atributo para asignar un número de versión a un ensamblado. En tiempo de compilación, esta información de versión se almacena con los metadatos del ensamblado. En tiempo de ejecución, el ejemplo recupera el valor de la Type.Assembly propiedad en un tipo que se encuentra en el ensamblado para obtener una referencia al ensamblado que se ejecuta y recupera información de versión del ensamblado de la Version propiedad de la AssemblyName objeto devuelto por la Assembly.GetName (método).

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: