Compartir a través de


Clase ComCompatibleVersionAttribute

 

Publicado: octubre de 2016

Indica a un cliente COM que todas las clases de la versión actual de un ensamblado son compatibles con las clases de una versión anterior del ensamblado.

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

Jerarquía de herencia

System.Object
  System.Attribute
    System.Runtime.InteropServices.ComCompatibleVersionAttribute

Sintaxis

[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class ComCompatibleVersionAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public ref class ComCompatibleVersionAttribute sealed : Attribute
[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)>]
[<ComVisibleAttribute(true)>]
type ComCompatibleVersionAttribute = 
    class
        inherit Attribute
    end
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited := False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class ComCompatibleVersionAttribute
    Inherits Attribute

Constructores

Nombre Descripción
System_CAPS_pubmethod ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32)

Inicializa una nueva instancia de la ComCompatibleVersionAttribute clase con la versión principal, versión secundaria, compilación y números de revisión del ensamblado.

Propiedades

Nombre Descripción
System_CAPS_pubproperty BuildNumber

Obtiene el número de compilación del ensamblado.

System_CAPS_pubproperty MajorVersion

Obtiene el número de versión principal del ensamblado.

System_CAPS_pubproperty MinorVersion

Obtiene el número de versión secundaria del ensamblado.

System_CAPS_pubproperty RevisionNumber

Obtiene el número de revisión del ensamblado.

System_CAPS_pubproperty TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

Métodos

Nombre Descripción
System_CAPS_pubmethod Equals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia es igual que un objeto especificado.(Heredado de Attribute).

System_CAPS_pubmethod GetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethod GetType()

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

System_CAPS_pubmethod IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethod Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.(Heredado de Attribute).

System_CAPS_pubmethod ToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

Implementaciones de interfaz explícitas

Nombre Descripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Comentarios

Este atributo se puede aplicar a los ensamblados.

De forma predeterminada, la Tlbexp.exe (Type Library Exporter) utiliza el número de versión de un ensamblado para calcular los identificadores de clase (CLSID). Todos los públicos, clases visible para COM reciben identificadores CLSID nuevos cada vez que se exporta una nueva versión de ensamblado.

Puede aplicar el ComCompatibleVersionAttribute atributo para forzar que todos los identificadores CLSID de las clases de la versión actual de un ensamblado para ser el mismo que el CLSID de las clases de una versión anterior del ensamblado. Siempre que el CLSID siguen siendo los mismos, una aplicación COM heredada puede utilizar la versión posterior de un ensamblado compatible después de desinstalar el ensamblado original. Si se aplica el System.Runtime.InteropServices.GuidAttribute a una clase para establecer explícitamente su CLSID la ComCompatibleVersionAttribute no tiene ningún efecto.

Las propiedades de este atributo se combinan para formar las cuatro partes de una versión de ensamblado. Especifique siempre la versión más antigua que el ensamblado actual es compatible con versiones anteriores, por lo que la versión se usa para calcular todos los identificadores CLSID del ensamblado.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar la versión 1.0.0.0 del ensamblado en un ensamblado con un número de versión superior. Independientemente de la nueva versión del ensamblado, todos los identificadores CLSID del ensamblado se generan utilizando la versión 1.0.0.0 en lugar de la versión de ensamblado actual.

using System;
using System.Reflection;
using System.Runtime.InteropServices;

[assembly: AssemblyVersion("3.0.0.0")]
[assembly: ComCompatibleVersion(1,0,0,0)]
namespace MyNamespace
{
    public class TheClass
    {
        // Insert code.
    }
}
Imports System
Imports System.Reflection
Imports System.Runtime.InteropServices

<assembly: AssemblyVersion("3.0.0.0")>
<assembly: ComCompatibleVersion(1,0,0,0)>
Namespace MyNamespace
    Public Class TheClass
        ' Insert code.
    End Class
End Namespace
using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;

[assembly: AssemblyVersion("3.0.0.0")];
[assembly: ComCompatibleVersion(1,0,0,0)];
namespace MyNamespace
{
    public ref class TheClass
    {
        // Insert code.
    };
};

Información de versión

.NET Framework
Disponible desde 1.1

Seguridad para subprocesos

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.

Ver también

GuidAttribute
Espacio de nombres System.Runtime.InteropServices
Tlbexp.exe (Type Library Exporter)

Volver al principio