InstalledProductRegistrationAttribute Clase

Referencia

Definición

Espacio de nombres:: Microsoft.VisualStudio.Shell

Ensamblado:: Microsoft.VisualStudio.Shell.14.0.dll

Ensamblado:: Microsoft.VisualStudio.Shell.15.0.dll

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Este atributo registra un "producto instalado" para el paquete.
Esto permite que el paquete presente información sobre la pantalla de presentación de VS o la Ayuda 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

Herencia: Attribute

RegistrationAttribute
InstalledProductRegistrationAttribute

Atributos: AttributeUsageAttribute

Comentarios

Cuándo llamar

Aplique este atributo a la clase VSPackage para proporcionar información que se muestra en la pantalla de presentación de Visual Studio y el cuadro de diálogo Ayuda sobre .

Uso básico

Create un InstalledProductRegistrationAttribute objeto para registrar el VSPackage con el cuadro de diálogo Ayuda acerca de . Los distintos constructores proporcionan las opciones para usar la IVsInstalledProduct interfaz (tal y como implementa el paquete) para recopilar la información y mostrarla en la pantalla de presentación de Visual Studio. Para usar este atributo, colóquelo en la clase VSPackage (una clase derivada de Package o una que implemente IVsPackage).

Este atributo solo se usa para proporcionar datos para herramientas de registro externas como regpkg.exe. No tiene ningún efecto en el comportamiento en tiempo de ejecución del VSPackage. Para obtener más información, consulte Registro de VSPackage.

Nota

Visual C# anexa automáticamente la palabra Attribute al nombre de cualquier clase de atributo. En el código de Visual C#, consulte este atributo como InstalledProductRegistration.

Entradas del Registro

Las siguientes entradas del Registro se crean mediante 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

Ejemplos

La ubicación estándar para este y todos los demás atributos usados para el registro automático son adyacentes a la implementación de Package en VsPkg.cs, VsPkg.vb o VsPkg.cpp, dependiendo del idioma usado en el ejemplo.

Constructores

InstalledProductRegistrationAttribute(String, String, String)

Crea un nuevo InstalledProductRegistrationAttribute para registrar el paquete con el cuadro de diálogo Ayuda/Acerca de. Esta es la información de registro más sencilla necesaria para los paquetes de terceros. Proporcionar detalles del producto no es un requisito, pero se recomienda.

Propiedades

IconResourceID	Identificador de recurso del icono.
LanguageIndependentName	Nombre del producto.
ProductDetails	Descripción detallada del producto.
ProductDetailsResourceID	Identificador de recurso para los detalles.
ProductId	Identificador del producto.
ProductName	Nombre del producto.
ProductNameResourceID	Identificador de recurso correspondiente al nombre del producto.
TypeId	Invalide la propiedad TypeID para permitir que las clases derivadas RegistrationAttribute funcionen con System.ComponentModel.TypeDescriptor.GetAttributes(...). Un atributo derivado de este tendrá que invalidar esta propiedad solo si necesita un mejor control en las instancias que se pueden aplicar a una clase. (Heredado de RegistrationAttribute)
UseInterface	Use IVsInstalledProduct para rellenar el cuadro de diálogo Ayuda sobre . El paquete debe implementar IVsInstalledProduct.
UsePackage	True es que la instalación del producto usará el identificador del paquete.
UseVsProductId	True es que el identificador de producto es el mismo que el id. de VisualStudio. Se reserva para el uso interno de Microsoft. Los paquetes de terceros deben proporcionar su propio identificador de producto cuando se construye la clase.

Métodos

GetPackageRegKeyPath(Guid)	Obtiene la ruta del Registro (en relación con la raíz del Registro de la aplicación) del Paquete VSPackage. (Heredado de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Se usa para registrar este atributo con el contexto determinado.
Unregister(RegistrationAttribute+RegistrationContext)	Anule el registro de esta entrada InstalledProducts.

Se aplica a

Compartir a través de