Compartilhar via


InstalledProductRegistrationAttribute Classe

Definição

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
InstalledProductRegistrationAttribute
Atributos

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.

Aplica-se a