Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

ComCompatibleVersionAttribute, classe

Indique à un client COM que toutes les classes de la version actuelle d'un assembly sont compatibles avec les classes d'une version précédente de l'assembly.

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

Espace de noms :  System.Runtime.InteropServices
Assembly :  mscorlib (dans mscorlib.dll)

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

Le type ComCompatibleVersionAttribute expose les membres suivants.

  NomDescription
Méthode publiqueComCompatibleVersionAttributeInitialise une nouvelle instance de la classe ComCompatibleVersionAttribute avec les numéros de version principale, de version secondaire, de build et de révision de l'assembly.
Début

  NomDescription
Propriété publiqueBuildNumberObtient le numéro de build de l'assembly.
Propriété publiqueMajorVersionObtient le numéro de version principale de l'assembly.
Propriété publiqueMinorVersionObtient le numéro de version secondaire de l'assembly.
Propriété publiqueRevisionNumberObtient le numéro de révision de l'assembly.
Propriété publiqueTypeIdLors de son implémentation dans une classe dérivée, obtient un identificateur unique pour Attribute. (Hérité de Attribute.)
Début

  NomDescription
Méthode publiqueEqualsInfrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeRetourne le code de hachage pour cette instance. (Hérité de Attribute.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueIsDefaultAttributeEn cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.)
Méthode publiqueMatchEn cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privée_Attribute.GetIDsOfNamesMappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée_Attribute.GetTypeInfoRécupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée_Attribute.GetTypeInfoCountRécupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée_Attribute.InvokeFournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)
Début

Vous pouvez appliquer cet attribut à des assemblys.

Par défaut, l'outil Tlbexp.exe (exportateur de bibliothèques de types) utilise le numéro de version d'un assembly pour calculer les identificateurs de classe (CLSID). Toutes les classes publiques visibles par COM reçoivent de nouveaux CLSID à chaque fois que vous exportez une nouvelle version d'assembly.

Vous pouvez appliquer l'attribut ComCompatibleVersionAttribute pour forcer tous les CLSID des classes de la version actuelle d'un assembly à être identiques aux CLSID des classes d'une version précédente de l'assembly. Tant que les CLSID restent identiques, une application COM héritée (legacy) peut utiliser la dernière version d'un assembly compatible après la désinstallation de l'assembly original. Si vous appliquez System.Runtime.InteropServices.GuidAttribute à une classe pour définir explicitement son CLSID, ComCompatibleVersionAttribute est sans effet.

Les propriétés de cet attribut se combinent pour former les quatre parties d'une version d'assembly. Spécifiez toujours la version la plus ancienne avec laquelle l'assembly en cours est compatible (compatibilité descendante), de manière à ce que cette version soit utilisée pour calculer tous les CLSID de l'assembly.

L'exemple suivant montre comment spécifier la version d'assembly 1.0.0.0 dans un assembly doté d'un numéro de version plus récent. Quelle que soit la nouvelle version d'assembly, tous les CLSID de l'assembly sont générés à l'aide de la version 1.0.0.0 au lieu d'utiliser la version d'assembly actuelle.


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

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft