InstalledProductRegistrationAttribute Classe

Référence

Définition

Espace de noms:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Paquet:: Microsoft.VisualStudio.Shell.15.0 v17.11.40262

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Cet attribut inscrit un « produit installé » pour votre package.
Cela permet à votre package de présenter des informations sur l’écran de démarrage de VS ou l’aide à propos.

public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)]
public sealed class InstalledProductRegistrationAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)>]
type InstalledProductRegistrationAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class InstalledProductRegistrationAttribute
Inherits RegistrationAttribute

Héritage: Attribute

RegistrationAttribute
InstalledProductRegistrationAttribute

Attributs: AttributeUsageAttribute

Remarques

Quand appeler

Appliquez cet attribut à votre classe VSPackage pour fournir des informations qui s’affichent sur l’écran de démarrage de Visual Studio et la boîte de dialogue Aide à propos de.

Utilisation de base

Create un InstalledProductRegistrationAttribute objet pour inscrire votre VSPackage avec la boîte de dialogue Aide à propos de. Les différents constructeurs fournissent les options permettant d’utiliser l’interface IVsInstalledProduct (telle qu’implémentée par le package) pour collecter les informations et les afficher sur l’écran de démarrage de Visual Studio. Pour utiliser cet attribut, placez-le sur votre classe VSPackage (une classe dérivée de Package ou qui implémente IVsPackage).

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

Notes

Visual C# ajoute automatiquement le mot Attribut au nom d’une classe d’attribut. Dans le code Visual C#, reportez-vous à cet attribut en tant que InstalledProductRegistration.

Entrées de Registre

Les entrées de 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. Code
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName

Exemples

L’emplacement standard de ce attribut et de tous les autres attributs utilisés pour l’inscription Package automatique est adjacent à l’implémentation de dans VsPkg.cs, VsPkg.vb ou VsPkg.cpp, selon la langue utilisée dans l’exemple.

Constructeurs

InstalledProductRegistrationAttribute(String, String, String)

Crée un nouvel objet InstalledProductRegistrationAttribute pour inscrire votre package avec la boîte de dialogue Aide/À propos. Il s’agit des informations d’inscription les plus simples nécessaires pour les packages tiers. Il n’est pas obligatoire de fournir les détails du produit, mais il est recommandé.

Propriétés

IconResourceID	ID de ressource de l’icône.
LanguageIndependentName	Nom de votre produit.
ProductDetails	Description détaillée de votre produit.
ProductDetailsResourceID	ID de ressource pour les détails.
ProductId	Votre ID de produit.
ProductName	Nom de votre produit.
ProductNameResourceID	ID de ressource correspondant au nom du produit.
TypeId	Remplacez la propriété TypeID afin de permettre aux classes dérivées RegistrationAttribute de fonctionner avec System.ComponentModel.TypeDescriptor.GetAttributes (...). Un attribut dérivé de celui-ci doit remplacer cette propriété uniquement s’il a besoin d’un meilleur contrôle sur les instances qui peuvent être appliquées à une classe. (Hérité de RegistrationAttribute)
UseInterface	Utilisez IVsInstalledProduct pour remplir la boîte de dialogue Aide sur. Le package doit implémenter IVsInstalledProduct.
UsePackage	True est que l’installation du produit utilise l’ID de package
UseVsProductId	True est que l’ID de produit est identique à l’ID VisualStudio. Il est réservé à l’utilisation interne de Microsoft. Les packages tiers doivent fournir leur propre ID de produit lorsque la classe est construite.

Méthodes

GetPackageRegKeyPath(Guid)	Obtient le chemin d'accès au Registre (relatif à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Appelé pour enregistrer cet attribut avec le contexte donné.
Unregister(RegistrationAttribute+RegistrationContext)	Annulez l’inscription de cette entrée InstalledProducts.

S’applique à

Partager via