InstalledProductRegistrationAttribute Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece informações para a tela inicial do Visual Studio e a caixa de diálogo ajuda sobre quando aplicada a uma Package classe derivada ou a uma classe que implementa IVsPackage . Essa classe não pode ser herdada.
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
- Atributos
Comentários
Quando chamar
Aplique esse atributo à sua classe VSPackage para fornecer informações que são exibidas na Visual Studio tela inicial e na caixa de diálogo ajuda .
Uso básico
Crie um InstalledProductRegistrationAttribute objeto para registrar seu VSPackage com a caixa de diálogo ajuda sobre . Os construtores diferentes fornecem as opções para usar a IVsInstalledProduct interface (conforme implementada pelo pacote) para coletar as informações e exibi-las na Visual Studio tela inicial. Para usar esse atributo, coloque-o em sua classe VSPackage (uma classe derivada de Package ou uma que implemente IVsPackage ).
Esse atributo é usado somente para fornecer dados para ferramentas de registro externas, como regpkg.exe. Ele não tem nenhum efeito sobre o comportamento de tempo de execução do VSPackage. Para obter mais informações, consulte VSPackage Registration.
Observação
Visual C# anexa automaticamente o atributo Word ao nome de qualquer classe de atributo. No Visual C# código, consulte esse atributo como InstalledProductRegistration.
Entradas do Registro
As seguintes entradas de 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 = ambos
<VSROOT>\CLSID \ {PackageGuid} \CodeBase = Context. Bases
<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 o 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) |
Inicializa uma nova instância do InstalledProductRegistrationAttribute com as informações do produto especificado. |
Propriedades
| IconResourceID |
Obtém ou define a ID de recurso do ícone associado ao produto. |
| LanguageIndependentName |
Obtém ou define o nome (não localizado) do produto. |
| ProductDetails |
Obtém ou define a descrição detalhada do produto. |
| ProductDetailsResourceID |
Obtém ou define a ID de recurso de detalhes do produto. |
| ProductId |
Obtém ou define a ID do produto. |
| ProductName |
Obtém ou define o nome do produto. |
| ProductNameResourceID |
Obtém ou define a ID de recurso do nome do produto. |
| TypeId |
Obtém a instância atual deste atributo. (Herdado de RegistrationAttribute) |
| UseInterface |
Obtém ou se o pacote implementa a IVsInstalledProduct interface para exibir um bitmap na tela inicial e informações na caixa de diálogo sobre no menu ajuda. |
| UsePackage |
Obtém ou define se a instalação do produto usa a ID do pacote. |
| UseVsProductId |
Determina se a ID do produto é igual à ID do Visual Studio. |
Métodos
| GetPackageRegKeyPath(Guid) |
Obtém o caminho do registro (relativo à raiz do registro do aplicativo) do VSPackage. (Herdado de RegistrationAttribute) |
| Register(RegistrationAttribute+RegistrationContext) |
Registra informações sobre um VSPackage quando chamado por uma ferramenta de registro externa, como regpkg.exe. |
| Unregister(RegistrationAttribute+RegistrationContext) |
Remove as informações de registro sobre um VSPackage quando chamado por uma ferramenta de registro externa, como regpkg.exe. |