ProvideLanguageEditorOptionPageAttribute 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í.

Proporcione un método general para establecer una página de opción de herramientas del editor del servicio de lenguaje.

public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideLanguageEditorOptionPageAttribute : Microsoft.VisualStudio.Shell.ProvideOptionDialogPageAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideLanguageEditorOptionPageAttribute = class
    inherit ProvideOptionDialogPageAttribute

Public NotInheritable Class ProvideLanguageEditorOptionPageAttribute
Inherits ProvideOptionDialogPageAttribute

Herencia: Attribute

RegistrationAttribute

ProvideOptionDialogPageAttribute
ProvideLanguageEditorOptionPageAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En este ejemplo se muestra cómo se usa este atributo definido por el usuario para registrar dos páginas de propiedades ("General" y "Sangría") y un nodo de página de propiedades ("Formato") que contiene la página de propiedades "Sangría". Observe cómo el segundo parámetro para el constructor especifica la posición en el Registro con respecto al nodo.

Nota

Visual C# permite una forma abreviada de un atributo definido por el usuario quitando la parte "Attribute" del nombre. Este formulario abreviado se usa en este y en todos los demás ejemplos de esta clase.

using Microsoft.VisualStudio.Shell;  

namespace MyLanguagePackage  
{  
    internal class MyConstants  
    {  
        public const string languageName                = "MyLanguage";  
        public const string formattingNodeResIDAsString = "#108";  
        public const string generalPageResIDAsString    = "#109";  
        public const string indentPageResIDAsString     = "#110";  
    }  

    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     "General",  // property page  
                                     MyConstants.generalPageResIDAsString,  
        // Optional language service properties  
        OptionPageGuid = "{12434534-cecd-48e7-a866-45cad2e8b169}"  
                                    )]  
    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     "Formatting",  // property node  
                                     MyConstants.formattingNodeResIDAsString  
                                    )]  
    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     @"Formatting\Indent",  // property page  
                                     MyConstants.indentPageResIDAsString,  
        // Optional language service properties  
        OptionPageGuid = "{12434556-cecd-48e7-a866-45cad2e8b169}"  
                                    )]  

    class MyLanguagePackage  
    {  
    }  
}

Comentarios

Esta información se almacena en la clave <del Registro RegistrationRoot>\Languages\Language Services\[language]\EditorToolsOptions, donde [idioma] es el nombre del idioma.

En EditorToolsOptions es un árbol de páginas y subpáginas que pueden anidar cualquier número de niveles. Estas páginas corresponden a las páginas de opciones que se muestran en la Visual Studio Tools Opciones para editores (donde se muestra un árbol de páginas de opciones bajo el nombre de idioma, cada página que contiene las opciones adecuadas).

Cada clave de esta lista de páginas de opciones contiene un identificador de recurso o una cadena literal que contiene el nombre localizado de la página. Esto es lo que se muestra realmente en el cuadro de diálogo Opciones de herramientas. Además, también contiene un GUID de paquete y, opcionalmente, un GUID de una página de opciones.

Si no hay ningún GUID de página de opción, la clave se considera un nodo en el árbol de opciones y no tiene ninguna página asociada. De lo contrario, la clave es una hoja del árbol y se mostrará su página de opciones.

Puede haber varias instancias de este atributo y cada instancia especifica un nodo o una página de propiedades. Los atributos pueden aparecer en cualquier orden. Si se especifica el GUID de la página de propiedades, se registra una página de propiedades; de lo contrario, es un nodo registrado.

Los siguientes atributos definidos por el usuario se usan para los servicios de lenguaje:

Atributo	Descripción
ProvideLanguageServiceAttribute	Registra el servicio de lenguaje con Visual Studio y especifica qué características se admiten.
ProvideLanguageExtensionAttribute	Asocia una extensión de archivo al servicio de lenguaje.
ProvideLanguageEditorOptionPageAttribute	Especifica un nodo de propiedad o página para el cuadro de diálogo Opciones específico del servicio de idioma.
ProvideLanguageCodeExpansionAttribute	Especifica información de ubicación para admitir fragmentos de código en el servicio de lenguaje.
ProvideServiceAttribute	Registra un servicio de lenguaje como un servicio de Visual Studio. Todos los servicios proporcionados en código administrado usan este atributo.

Notas a los desarrolladores de herederos

Esta clase de atributo no se puede heredar de , por lo que no hay nada que implementar.

Notas a los autores de las llamadas

Esta clase de atributo se suele aplicar a la clase VSPackage principal, aunque puede aparecer en cualquier clase. Esta clase de atributo puede aparecer varias veces y en cualquier orden, una vez para cada página de propiedades y nodo en el árbol de páginas de propiedades.

Constructores

ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, Int32)	Crea una instancia nueva de ProvideLanguageEditorOptionPageAttribute.
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String)	Crea una instancia nueva de ProvideLanguageEditorOptionPageAttribute.
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String[])	Crea una instancia nueva de ProvideLanguageEditorOptionPageAttribute.

Propiedades

IsInUnifiedSettings	Obtiene o establece un valor que indica si la configuración de esta página se ha incorporado a La configuración unificada mediante la creación de un nuevo registro. Si es true, la página se oculta cuando la configuración unificada está habilitada para que su configuración no esté duplicada.
Keywords	Obtiene las palabras clave.
LanguageName	Obtiene el nombre del idioma.
PageGuid	Obtiene el GUID de la página de opción.
PageNameResourceId	Obtiene el identificador de recursos de nombre de la página. (Heredado de ProvideOptionDialogPageAttribute)
PageType	Obtiene el tipo de la página. (Heredado de ProvideOptionDialogPageAttribute)
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)

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)	Crea todas las claves y entradas del Registro según se especifica en el constructor de clase.
Unregister(RegistrationAttribute+RegistrationContext)	Quita todas las claves y entradas del Registro.

Se aplica a

Compartir a través de