ComCompatibleVersionAttribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wskazuje na klienta COM, że wszystkie klasy w bieżącej wersji zestawu są zgodne z klasami we wcześniejszej wersji zestawu.

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

Dziedziczenie: Object

Attribute
ComCompatibleVersionAttribute

Atrybuty: AttributeUsageAttribute ComVisibleAttribute

Przykłady

W poniższym przykładzie pokazano, jak określić wersję zestawu 1.0.0.0 w zestawie z wyższym numerem wersji. Niezależnie od nowej wersji zestawu wszystkie identyfikatory CLSID w zestawie są generowane przy użyciu wersji 1.0.0.0 zamiast używać bieżącej wersji zestawu.

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

Uwagi

Ten atrybut można zastosować do zestawów.

Domyślnie Tlbexp.exe (eksporter biblioteki typów) używa numeru wersji zestawu do obliczania identyfikatorów klas (CLSID). Wszystkie publiczne klasy widoczne dla modelu COM otrzymują nowe identyfikatory CLSID za każdym razem, gdy eksportujesz nową wersję zestawu.

Atrybut można zastosować ComCompatibleVersionAttribute , aby wymusić wszystkie identyfikatory CLSID dla klas w bieżącej wersji zestawu tak samo jak identyfikatory CLSID dla klas we wcześniejszej wersji zestawu. Dopóki identyfikatory CLSID pozostaną takie same, starsza aplikacja COM może używać nowszej wersji zgodnego zestawu po odinstalowaniu oryginalnego zestawu. Jeśli zastosujesz klasę System.Runtime.InteropServices.GuidAttribute do jawnego ustawienia identyfikatora CLSID, ComCompatibleVersionAttribute nie ma to wpływu.

Właściwości tego atrybutu łączą się w celu utworzenia czterech części wersji zestawu. Zawsze określ najniższą wersję, z którą bieżący zestaw jest zgodny z poprzednimi wersjami, dzięki czemu wersja jest używana do obliczania wszystkich identyfikatorów CLSID w zestawie.

Konstruktory

ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32)

Inicjuje ComCompatibleVersionAttribute nowe wystąpienie klasy z główną wersją, wersją pomocniczą, kompilacją i numerami poprawek zestawu.

Właściwości

BuildNumber	Pobiera numer kompilacji zestawu.
MajorVersion	Pobiera numer wersji głównej zestawu.
MinorVersion	Pobiera numer wersji pomocniczej zestawu.
RevisionNumber	Pobiera numer poprawki zestawu.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Dotyczy