InstalledProductRegistrationAttribute, classe

Fournit des informations pour l'écran de démarrage de Visual Studio et la boîte de dialogue de À propos de une fois appliqué à Package - classe dérivée ou une classe qui implémente IVsPackage.Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.InstalledProductRegistrationAttribute

Espace de noms :  Microsoft.VisualStudio.Shell
Assembly :  Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
<AttributeUsageAttribute(AttributeTargets.Class, Inherited := False)> _
Public NotInheritable Class InstalledProductRegistrationAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, Inherited = false)]
public sealed class InstalledProductRegistrationAttribute : RegistrationAttribute

Le type InstalledProductRegistrationAttribute expose les membres suivants.

Constructeurs

	Nom	Description
	InstalledProductRegistrationAttribute(String, String, String)	Initialise une nouvelle instance d'InstalledProductRegistrationAttribute avec les informations sur le produit spécifiée.
	InstalledProductRegistrationAttribute(Boolean, String, String, String)	Obsolète. Initialise une nouvelle instance d'InstalledProductRegistrationAttribute pour le produit spécifié.
	InstalledProductRegistrationAttribute(String, String, String, Boolean)	Initialise une nouvelle instance d'InstalledProductRegistrationAttribute que le produit spécifié de détails.

Début

Propriétés

	Nom	Description
	IconResourceID	Obtient ou définit l'ID de ressource de l'icône associée avec le produit.
	LanguageIndependentName	Obtient ou définit le nom (non- localisé) du produit.
	ProductDetails	Obtient ou définit la description détaillée du produit.
	ProductDetailsResourceID	Obtient ou définit les détails de produit ID de ressource
	ProductId	Obtient ou définit l'ID de produit.
	ProductName	Obtient ou définit le nom du produit.
	ProductNameResourceID	Obtient ou définit l'ID de ressource du nom de produit.
	TypeId	Obtient l'instance actuel de cet attribut. (Hérité de RegistrationAttribute.)
	UseInterface	Obtient ou si le package implémente l'interface d'IVsInstalledProduct pour afficher une bitmap dans l'écran de démarrage et les informations dans la boîte de dialogue de À propos de sur le menu d'Aide.
	UsePackage	Obtient ou définit si l'installation de produit utilise l'ID de package
	UseVsProductId	Détermine si l'ID de produit est le même que l'ID de Visual Studio

Début

Méthodes

	Nom	Description
	Equals	Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
	Finalize	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.)
	GetHashCode	Retourne le code de hachage de cette instance. (Hérité de Attribute.)
	GetPackageRegKeyPath	Obtient le chemin d'accès au Registre (par rapport à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IsDefaultAttribute	En 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.)
	Match	En 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.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	Register	Enregistre des informations sur un VSPackage une fois appelé par un outil externe d'alignement tel que regpkg.exe. (Substitue RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext).)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	Unregister	Supprime les informations d'inscription sur un VSPackage une fois appelé par un outil externe d'alignement tel que regpkg.exe. (Substitue RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext).)

Début

Implémentations d'interface explicite

	Nom	Description
	_Attribute.GetIDsOfNames	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
	_Attribute.GetTypeInfo	Ré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.)
	_Attribute.GetTypeInfoCount	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
	_Attribute.Invoke	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)

Début

Remarques

Lorsque appeler

Appliquez-vous cet attribut à votre classe d'un VSPackage pour fournir des informations qui sont affichées sur l'écran de démarrage de Visual Studio et la boîte de dialogue de À propos de.

Utilisation de base

Créez un objet d'InstalledProductRegistrationAttribute pour enregistrer votre VSPackage avec la boîte de dialogue de À propos de.Les différents constructeurs fournissent les options d'utiliser l'interface d'IVsInstalledProduct (comme implémenté par le package) pour rassembler les informations et pour les afficher sur l'écran de démarrage de Visual Studio.Pour utiliser cet attribut, placez- sur votre classe d'un VSPackage (une classe dérivée d'Package ou d'un qui implémente IVsPackage).

Cet attribut est utilisé pour fournir uniquement des données pour les outils externes d'alignement comme regpkg.exe.Il n'a aucun effet sur le comportement d'exécution du VSPackage.Pour plus d'informations, consultez Inscription d'un VSPackage.

[!REMARQUE]

Visual C# ajoute automatiquement l'attribut de mot au nom de toute classe d'attributs.En code de Visual C#, reportez -vous à cet attribut comme InstalledProductRegistration.

Entrées du Registre

Les entrées du Registre suivantes sont créées par InstalledProductRegistrationAttribute :

• <VSROOT>\CLSID\{PackageGuid}

• <VSROOT>\CLSID\{PackageGuid}\@=ObjectType.FullName

• <VSROOT>\CLSID\{PackageGuid}\InprocServer32=mscoree.dll

• <VSROOT>\CLSID\{PackageGuid}\Class=ObjectType.FullName

• <VSROOT>\CLSID\{PackageGuid}\Assembly=ObjectType.Assembly.FullName

• <VSROOT>\CLSID\{PackageGuid}\ThreadingModel=Both

• <VSROOT>\CLSID\{PackageGuid}\CodeBase=context.CodeBase

• <VSROOT>\CLSID\{PackageGuid}\SatelliteDll

• <VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath

• <VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName

Exemples

L'emplacement standard pour cela et toutes les autres l'attribue utilisé pour l'alignement automatique est en regard de l'implémentation d'Package dans VsPkg.cs, VsPkg.vb, ou VsPkg.cpp, selon le langage utilisé dans l'exemple.

Sécurité des threads

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.

Voir aussi

Référence

Microsoft.VisualStudio.Shell, espace de noms

Autres ressources

Inscription d'un VSPackage

Ressources localisées dans des applications MFC : DLL satellites