ComCompatibleVersionAttribute Klasse

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: ComCompatibleVersionAttribute.cs

Quelle:: ComCompatibleVersionAttribute.cs

Quelle:: ComCompatibleVersionAttribute.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt für einen COM-Client an, dass alle Klassen in der aktuellen Version einer Assembly mit den Klassen in einer früheren Version der betreffenden Assembly kompatibel sind.

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

Vererbung: Object

Attribute
ComCompatibleVersionAttribute

Attribute: AttributeUsageAttribute ComVisibleAttribute

Beispiele

Das folgende Beispiel zeigt, wie Assemblyversion 1.0.0.0 in einer Assembly mit einer höheren Versionsnummer angegeben wird. Unabhängig von der neuen Assemblyversion werden alle CLSIDs in der Assembly mit Version 1.0.0.0 anstelle der aktuellen Assemblyversion generiert.

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

Hinweise

Sie können dieses Attribut auf Assemblys anwenden.

Standardmäßig verwendet der Tlbexp.exe (Type Library Exporter) die Versionsnummer einer Assembly, um Klassenbezeichner (CLSIDs) zu berechnen. Alle öffentlichen, COM-sichtbaren Klassen erhalten jedes Mal neue CLSIDs, wenn Sie eine neue Assemblyversion exportieren.

Sie können das ComCompatibleVersionAttribute -Attribut anwenden, um zu erzwingen, dass alle CLSIDs für Klassen in der aktuellen Version einer Assembly mit CLSIDs für Klassen in einer früheren Version der Assembly identisch sind. Solange die CLSIDs identisch bleiben, kann eine ältere COM-Anwendung die höhere Version einer kompatiblen Assembly verwenden, nachdem Sie die ursprüngliche Assembly deinstalliert haben. Wenn Sie die System.Runtime.InteropServices.GuidAttribute auf eine Klasse anwenden, um die CLSID explizit festzulegen, hat die ComCompatibleVersionAttribute keine Auswirkung.

Die Eigenschaften dieses Attributs werden zu den vier Teilen einer Assemblyversion kombiniert. Geben Sie immer die niedrigste Version an, mit der die aktuelle Assembly abwärtskompatibel ist, damit diese Version zum Berechnen aller CLSIDs in der Assembly verwendet wird.

Konstruktoren

ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32)

Initialisiert eine neue Instanz der ComCompatibleVersionAttribute-Klasse mit der Hauptversions-, Nebenversions-, Build- und Revisionsnummer der Assembly.

Eigenschaften

BuildNumber	Ruft die Buildnummer der Assembly ab.
MajorVersion	Ruft die Hauptversionsnummer der Assembly ab.
MinorVersion	Ruft die Nebenversionsnummer der Assembly ab.
RevisionNumber	Ruft die Revisionsnummer der Assembly ab.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für:

Freigeben über