ComCompatibleVersionAttribute Clase

Definición

public ref class ComCompatibleVersionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class ComCompatibleVersionAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComCompatibleVersionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type ComCompatibleVersionAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComCompatibleVersionAttribute = class
    inherit Attribute

Public NotInheritable Class ComCompatibleVersionAttribute
Inherits Attribute

Herencia

Object

Attribute

ComCompatibleVersionAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

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 CLSID del ensamblado se generan con la versión 1.0.0.0 en lugar de usar la versión actual del ensamblado.

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.
    };
};

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

Comentarios

Puede aplicar este atributo a los ensamblados.

De forma predeterminada, el Tlbexp.exe (Exportador de la biblioteca de tipos) usa el número de versión de un ensamblado para calcular identificadores de clase (CLSID). Todas las clases públicas y visibles para COM reciben nuevos CLSID cada vez que se exporta una nueva versión de ensamblado.

Puede aplicar el ComCompatibleVersionAttribute atributo para forzar que todos los CLSID para las clases de la versión actual de un ensamblado sean los mismos que los CLSID para las clases de una versión anterior del ensamblado. Siempre que los CLSID sigan siendo los mismos, una aplicación COM heredada puede usar la versión posterior de un ensamblado compatible después de desinstalar el ensamblado original. Si aplica a System.Runtime.InteropServices.GuidAttribute una clase para establecer explícitamente su CLSID, no ComCompatibleVersionAttribute 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 baja con la que el ensamblado actual es compatible con versiones anteriores para que se use para calcular todos los CLSID del ensamblado.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• GuidAttribute
• Tlbexp.exe (Exportador de la biblioteca de tipos)