ComCompatibleVersionAttribute Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Zdroj:

ComCompatibleVersionAttribute.cs

Označuje klienta modelu COM, že všechny třídy v aktuální verzi sestavení jsou kompatibilní s třídami v dřívější verzi sestavení.

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)>]
type ComCompatibleVersionAttribute = class
    inherit Attribute

Public NotInheritable Class ComCompatibleVersionAttribute
Inherits Attribute

Dědičnost

Object

Attribute

ComCompatibleVersionAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak zadat sestavení verze 1.0.0.0 v sestavení s vyšším číslem verze. Bez ohledu na novou verzi sestavení se všechny identifikátory CLSI v sestavení generují pomocí verze 1.0.0.0 namísto použití aktuální verze sestavení.

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

Poznámky

Tento atribut můžete použít na sestavení.

Ve výchozím nastavení Tlbexp.exe (exportér knihovny typů) používá číslo verze sestavení k výpočtu identifikátorů tříd (CLSID). Všechny veřejné, viditelné třídy MODELU COM obdrží nové identifikátory CLSI pokaždé, když exportujete novou verzi sestavení.

Atribut lze použít ComCompatibleVersionAttribute k vynucení všech identifikátorů CLSId pro třídy v aktuální verzi sestavení, aby byly stejné jako IDENTIFIKÁTORy CLSI pro třídy v dřívější verzi sestavení. Pokud identifikátory CLSI Zůstávají stejné, starší verze aplikace MODELU COM může po odinstalaci původního sestavení použít novější verzi kompatibilního sestavení. Pokud použijete System.Runtime.InteropServices.GuidAttribute u třídy explicitní nastavení jeho CLSID, ComCompatibleVersionAttribute nemá žádný vliv.

Vlastnosti tohoto atributu kombinují čtyři části verze sestavení. Vždy zadejte nejnižší verzi, se kterou je aktuální sestavení zpětně kompatibilní, aby se tato verze použila k výpočtu všech identifikátorů CLSID v sestavení.

Konstruktory

Name	Description
ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32)	Inicializuje novou instanci ComCompatibleVersionAttribute třídy s hlavní verzí, podverze, sestavení a čísla revizí sestavení.

Vlastnosti

Name	Description
BuildNumber	Získá číslo sestavení sestavení.
MajorVersion	Získá číslo hlavní verze sestavení.
MinorVersion	Získá číslo podverze sestavení.
RevisionNumber	Získá číslo revize sestavení.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• GuidAttribute
• Tlbexp.exe (exportér knihovny typů)