ComCompatibleVersionAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

ComCompatibleVersionAttribute

Attributi

AttributeUsageAttribute ComVisibleAttribute

Esempio

Nell'esempio seguente viene illustrato come specificare la versione dell'assembly 1.0.0.0 in un assembly con un numero di versione superiore. Indipendentemente dalla nuova versione dell'assembly, tutti i CLSID nell'assembly vengono generati usando la versione 1.0.0.0 anziché la versione corrente dell'assembly.

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

Commenti

È possibile applicare questo attributo agli assembly.

Per impostazione predefinita, il Tlbexp.exe (Utilità di esportazione libreria dei tipi) usa il numero di versione di un assembly per calcolare gli identificatori di classe (CLSID). Tutte le classi pubbliche e visibili a COM ricevono nuovi CLSID ogni volta che si esporta una nuova versione dell'assembly.

È possibile applicare l'attributo ComCompatibleVersionAttribute per forzare tutti i CLSID per le classi nella versione corrente di un assembly allo stesso modo dei CLSID per le classi in una versione precedente dell'assembly. Purché i CLSID rimangano invariati, un'applicazione COM legacy può usare la versione successiva di un assembly compatibile dopo la disinstallazione dell'assembly originale. Se si applica a System.Runtime.InteropServices.GuidAttribute una classe per impostare in modo esplicito il relativo CLSID, l'oggetto ComCompatibleVersionAttribute non ha alcun effetto.

Le proprietà di questo attributo vengono combinate per formare le quattro parti di una versione dell'assembly. Specificare sempre la versione più bassa con cui l'assembly corrente è compatibile con le versioni precedenti in modo che venga usata per calcolare tutti i CLSID nell'assembly.

Vedi anche

• GuidAttribute
• Tlbexp.exe (utilità di esportazione della libreria dei tipi)