ProvideLanguageServiceAttribute Classe

Definizione

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

Ereditarietà

Attribute

RegistrationAttribute

ProvideLanguageServiceAttribute

Attributi

AttributeUsageAttribute

Esempio

In questo esempio viene illustrato come viene usato questo attributo definito dall'utente per registrare un servizio linguistico che supporta operazioni intelliSense, corrispondenza parentesi graffe, analisi asincrona (sfondo) e elementi coloribili personalizzati.

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  
    {  
    }  
}  

Commenti

Questo attributo definito dall'utente (specifico per Visual C#) viene usato per fornire informazioni necessarie per registrare un servizio del linguaggio con Visual Studio. I valori specificati da questo attributo vengono archiviati come metadati nell'assembly. Questi metadati vengono usati in seguito da un programma, ad esempio regpkg.exe (parte di VSIP SDK) per creare le chiavi e le voci del Registro di sistema corrispondenti che indicano a Visual Studio il servizio linguistico.

Le voci del Registro di sistema interessate dall'oggetto ProvideLanguageServiceAttribute sono disponibili nella chiave del Registro di sistema seguente:

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]  

Dove [X.Y] è la versione di Visual Studio, ad esempio 8.0Exp e [nome lingua] è il nome della lingua (come specificato nel secondo parametro per il costruttore della ProvideLanguageServiceAttribute classe).

Il costruttore della classe specifica i parametri minimi necessari. Una classe di attributo definita dall'utente supporta anche parametri denominati facoltativi. Questi parametri denominati vengono specificati nell'elenco dei parametri del costruttore dopo i parametri necessari. Tutte le proprietà di questa classe che supportano sia gli operatori get che set possono essere specificati come parametro denominato. Nell'esempio viene illustrato il modo in cui vengono usati i parametri denominati.

Gli attributi definiti dall'utente seguenti vengono usati per i servizi linguistici:

Note per gli eredi

Questa classe di attributi non può essere ereditata da in modo che non sia necessario implementare nulla.

Note per i chiamanti

Questa classe di attributi viene in genere applicata alla classe VSPackage primaria, anche se può essere visualizzata in qualsiasi classe. Questa classe deve essere visualizzata una sola volta per ogni servizio linguistico supportato da VSPackage.

Costruttori

Proprietà

Metodi

Si applica a