ComCompatibleVersionAttribute Classe

Definição

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

Herança

Object

Attribute

ComCompatibleVersionAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Exemplos

O exemplo seguinte mostra como especificar a versão assembly 1.0.0.0 numa assembly com um número de versão superior. Independentemente da nova versão de assembly, todos os CLSIDs no assembly são gerados usando a versão 1.0.0.0 em vez da versão assembly atual.

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

Observações

Pode aplicar este atributo a assemblies.

Por defeito, o Tlbexp.exe (Type Library Exporter) usa o número de versão de um assembly para calcular identificadores de classe (CLSIDs). Todas as classes públicas, COM-visibles, recebem novos CLSIDs cada vez que exporta uma nova versão de assembly.

Pode aplicar o ComCompatibleVersionAttribute atributo para forçar que todos os CLSIDs para classes na versão atual de um assembly sejam iguais aos CLSIDs para classes numa versão anterior do assembly. Desde que os CLSIDs se mantenham iguais, uma aplicação COM legada pode usar a versão posterior de um assembly compatível depois de desinstalar o assembly original. Se aplicar o System.Runtime.InteropServices.GuidAttribute a uma classe para definir explicitamente o seu CLSID, não ComCompatibleVersionAttribute tem efeito.

As propriedades deste atributo combinam-se para formar as quatro partes de uma versão de montagem. Especifique sempre a versão mais baixa com a qual o conjunto atual é compatível com versões anteriores, para que essa versão seja usada para calcular todos os CLSIDs do conjunto.

Ver também

• GuidAttribute
• Tlbexp.exe (Exportador de Biblioteca de Tipos)