(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ComCompatibleVersionAttribute-Klasse

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.

System.Object
  System.Attribute
    System.Runtime.InteropServices.ComCompatibleVersionAttribute

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class ComCompatibleVersionAttribute : Attribute

Der ComCompatibleVersionAttribute-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeComCompatibleVersionAttributeInitialisiert eine neue Instanz der ComCompatibleVersionAttribute-Klasse mit der Hauptversions-, Nebenversions-, Build- und Revisionsnummer der Assembly.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftBuildNumberRuft die Buildnummer der Assembly ab.
Öffentliche EigenschaftMajorVersionRuft die Hauptversionsnummer der Assembly ab.
Öffentliche EigenschaftMinorVersionRuft die Nebenversionsnummer der Assembly ab.
Öffentliche EigenschaftRevisionNumberRuft die Revisionsnummer der Assembly ab.
Öffentliche EigenschaftTypeIdBei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEqualsInfrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
Öffentliche MethodeGetHashCodeGibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsDefaultAttributeBeim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
Öffentliche MethodeMatchBeim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetIDsOfNamesOrdnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoRuft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoCountRuft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.InvokeStellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)
Zum Seitenanfang

Dieses Attribut kann auf Assemblys angewendet werden.

Tlbexp.exe (Type Library Exporter-Tool) verwendet standardmäßig die Versionsnummer einer Assembly, um CLSIDs (Class Identifiers, Klassen-IDs) zu berechnen. Alle öffentlichen, COM-sichtbaren Klassen empfangen immer dann neue CLSIDs, wenn eine neue Assemblyversion exportiert wird.

Sie können das ComCompatibleVersionAttribute-Attribut anwenden, um zu erzwingen, dass alle CLSIDs für Klassen in der aktuellen Version einer Assembly mit den CLSIDs für Klassen in einer früheren Version der Assembly identisch sind. Solange die CLSIDs unverändert bleiben, kann eine ältere COM-Anwendung nach dem Deinstallieren der ursprünglichen Assembly die spätere Version einer kompatiblen Assembly verwenden. Wenn System.Runtime.InteropServices.GuidAttribute auf eine Klasse angewendet wird, um die deren CLSID explizit festzulegen, hat ComCompatibleVersionAttribute keine Auswirkungen.

Die Eigenschaften dieses Attributs werden kombiniert, sodass sie die vier Teile einer Assemblyversion bilden. Geben Sie immer die niedrigste Version an, mit der die aktuelle Assembly abwärtskompatibel ist, sodass mit der betreffenden Version alle CLSIDs in der Assembly berechnet werden.

Das folgende Beispiel veranschaulicht, wie die Assemblyversion 1.0.0.0 in einer Assembly mit einer höheren Versionsnummer angegeben wird. Ungeachtet der neuen Assemblyversion werden alle CLSIDs in der Assembly mit Version 1.0.0.0 anstatt mit der aktuellen Assemblyversion generiert.


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


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft