ComCompatibleVersionAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Označuje klientovi 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)]
[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
- Dědičnost
- Atributy
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 mí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 u 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 (CLSIDs). Všechny veřejné, viditelné třídy modelu COM obdrží nové identifikátory CLSID při každém exportu nové verze sestavení.
Atribut můžete použít ComCompatibleVersionAttribute
k vynucení všech identifikátorů CLSIDs pro třídy v aktuální verzi sestavení tak, aby byly stejné jako identifikátory CLSIDs pro třídy v dřívější verzi sestavení. Pokud identifikátory CLSID zůstanou stejné, starší 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á to žádný vliv.
Vlastnosti tohoto atributu zkombinují a tvoří č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
ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32) |
Inicializuje novou instanci ComCompatibleVersionAttribute třídy s hlavní verzí, podverzi, sestavením a čísly revizí sestavení. |
Vlastnosti
BuildNumber |
Získá číslo sestavení sestavení. |
MajorVersion |
Získá hlavní číslo 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
Equals(Object) |
Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute) |
GetHashCode() |
Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute) |
GetType() |
Type Získá aktuální instanci. (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 odvozené třídy. (Zděděno od Attribute) |
Match(Object) |
Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute) |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Explicitní implementace rozhraní
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Načte informace o typu objektu, který lze použít k získání informací o typu rozhraní. (Zděděno od Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute) |