ProvideLanguageServiceAttribute Clase

Definición

public ref class ProvideLanguageServiceAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class ProvideLanguageServiceAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

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

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

Public NotInheritable Class ProvideLanguageServiceAttribute
Inherits RegistrationAttribute

Herencia

Attribute

RegistrationAttribute

ProvideLanguageServiceAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En este ejemplo se muestra cómo se usa este atributo definido por el usuario para registrar un servicio de lenguaje que admite operaciones de IntelliSense, coincidencia de llaves, análisis asincrónico (fondo) y elementos colorables personalizados.

using Microsoft.VisualStudio.Shell;  

namespace MyLanguagePackage  
{  
    internal class MyConstants  
    {  
        public const string languageName           = "MyLanguage";  
        public const int    languageNameResourceID = 106;  
    }  

    [ProvideLanguageService(typeof(MyLanguageService),  
                            MyConstants.languageName,  
                            MyConstants.languageNameResourceID,  
        // Optional language service properties  
        CodeSense             = true,  // General IntelliSense support  
        RequestStockColors    = false, // Custom colorable items  
        EnableASyncCompletion = true,  // supports background parsing  
        MatchBraces           = true,  // Match braces on command  
        MatchBracesAtCaret    = true   // Match braces while typing  
                           )]  

    class MyLanguagePackage  
    {  
    }  
}  

Comentarios

Este atributo definido por el usuario (que es específico de Visual C#) se usa para proporcionar información necesaria para registrar un servicio de lenguaje con Visual Studio. Los valores especificados por este atributo se almacenan como metadatos en el ensamblado. Más adelante, un programa como regpkg.exe (parte del SDK de VSIP) usa estos metadatos para crear las claves del Registro y las entradas correspondientes que indican a Visual Studio sobre el servicio de lenguaje.

Las entradas del Registro afectadas por ProvideLanguageServiceAttribute se encuentran en la siguiente clave del Registro:

HKEY_LOCAL_MACHINE\  
  SOFTWARE\  
    Microsoft\  
      VisualStudio\  
        [X.Y]\  
          Languages\  
            Language Services\  
              [language name]\  
                (Default) = reg_sz: [Language Service GUID]  
                Package   = reg_sz: [Package GUID]  
                LangResID = reg_dword: [language name resource ID]  

Donde [X.Y] es la versión de Visual Studio, por ejemplo, 8.0Exp y [nombre de idioma] es el nombre del idioma (como se especifica en el segundo parámetro para el constructor de ProvideLanguageServiceAttribute clase).

El constructor de clase especifica los parámetros mínimos necesarios. Una clase de atributo definida por el usuario también admite parámetros con nombre opcionales. Estos parámetros con nombre se especifican en la lista de parámetros del constructor después de los parámetros necesarios. Todas las propiedades de esta clase que admiten operadores get y set se pueden especificar como un parámetro con nombre. En el ejemplo se muestra cómo se usan los parámetros con nombre.

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

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 aplica normalmente a la clase VSPackage principal, aunque puede aparecer en cualquier clase. Esta clase solo debe aparecer una vez para cada servicio de lenguaje que admita VSPackage.

Constructores

Propiedades

Métodos

Se aplica a