InstalledProductRegistrationAttribute Classe

Definição

Namespace:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Pacote:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Esse atributo registra um 'produto instalado' para seu pacote.
Isso permite que seu pacote apresente informações na Tela inicial do VS ou na Ajuda Sobre.

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

Herança

Attribute

RegistrationAttribute

InstalledProductRegistrationAttribute

Atributos

AttributeUsageAttribute

Comentários

Quando chamar

Aplique esse atributo à classe VSPackage para fornecer informações exibidas na tela inicial do Visual Studio e na caixa de diálogo Ajuda Sobre .

Uso básico

Create um InstalledProductRegistrationAttribute objeto para registrar seu VSPackage com a caixa de diálogo Ajuda Sobre. Os diferentes construtores fornecem as opções para usar a IVsInstalledProduct interface (conforme implementado pelo pacote) para coletar as informações e exibi-la na tela inicial do Visual Studio. Para usar esse atributo, coloque-o em sua classe VSPackage (uma classe derivada de Package ou uma que implementa IVsPackage).

Esse atributo é usado apenas para fornecer dados para ferramentas de registro externas, como regpkg.exe. Ele não tem nenhum efeito sobre o comportamento de runtime do VSPackage. Para obter mais informações, consulte Registro do VSPackage.

Observação

O Visual C# acrescenta automaticamente a palavra Atributo ao nome de qualquer classe de atributo. No código do Visual C#, consulte esse atributo como InstalledProductRegistration.

Entradas do Registro

As seguintes entradas do Registro são criadas por 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

Exemplos

O local padrão para esse e todos os outros atributos usados para registro automático é adjacente à implementação do Package em VsPkg.cs, VsPkg.vb ou VsPkg.cpp, dependendo do idioma usado no exemplo.

Construtores

InstalledProductRegistrationAttribute(String, String, String)

Cria um novo InstalledProductRegistrationAttribute para registrar seu pacote com a caixa de diálogo Ajuda/Sobre. Essas são as informações de registro mais simples necessárias para pacotes de terceiros. Fornecer detalhes do produto não é um requisito, mas é recomendado.

Propriedades

IconResourceID	ID do recurso do ícone.
LanguageIndependentName	O nome do seu produto.
ProductDetails	Descrição detalhada do seu produto.
ProductDetailsResourceID	ID do recurso para os detalhes.
ProductId	Sua ID do produto.
ProductName	O nome do seu produto.
ProductNameResourceID	ID do recurso correspondente ao nome do produto.
TypeId	Substitua a propriedade TypeID para permitir que as classes derivadas de RegistrationAttribute funcionem com System.ComponentModel.TypeDescriptor.GetAttributes(...). Um atributo derivado deste terá que substituir essa propriedade somente se precisar de um controle melhor sobre as instâncias que podem ser aplicadas a uma classe. (Herdado de RegistrationAttribute)
UseInterface	Use IVsInstalledProduct para preencher a caixa de diálogo Ajuda sobre. O pacote deve implementar IVsInstalledProduct.
UsePackage	True é que a instalação do produto usará a ID do pacote
UseVsProductId	True é que a ID do produto é igual à ID do VisualStudio Que é reservada para uso interno da Microsoft. Os pacotes de terceiros devem fornecer sua própria ID de produto quando a classe for construída.

Métodos

GetPackageRegKeyPath(Guid)	Obtém o caminho do Registro (em relação à raiz do registro do aplicativo) do VSPackage. (Herdado de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Chamado para registrar esse atributo com o contexto determinado.
Unregister(RegistrationAttribute+RegistrationContext)	Cancele o registro desta entrada InstalledProducts.