ProvideLanguageExtensionAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Associa un'estensione di file con un servizio di linguaggio particolare.

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

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

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

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

Public NotInheritable Class ProvideLanguageExtensionAttribute
Inherits RegistrationAttribute

Ereditarietà: Attribute

RegistrationAttribute
ProvideLanguageExtensionAttribute

Attributi: AttributeUsageAttribute

Esempio

In questo esempio viene illustrato come associare l'estensione del file ".myext" a un servizio linguistico.

Nota

Visual C# consente una forma abbreviata di un attributo definito dall'utente eliminando la parte "Attributo" del nome. Questo modulo a breve viene usato in questo e tutti gli altri esempi in questa classe.

using Microsoft.VisualStudio.Shell;  

namespace MyLanguagePackage  
{  
    [ProvideLanguageExtension(typeof(MyLanguageService), ".myext")]  
    public class MyLanguagePackage : Package  
    {  
    }  
}

Commenti

Questo attributo C# definito dall'utente viene usato per registrare con Visual Studio un'estensione di file per un servizio di linguaggio specifico. Questo attributo inserisce le informazioni necessarie nei metadati dell'assembly recuperati e usati in seguito da regpkg.exe. È comunque necessario registrare il servizio linguistico stesso; questo attributo rende solo l'associazione tra l'estensione del file e il servizio linguistico. Per altre informazioni, vedere Registrazione di VSPackage.

È possibile usare più istanze di questo attributo per associare più estensioni di file al servizio linguistico.

La chiave del Registro di sistema interessata da questo attributo esiste nella chiave del Registro di sistema di Visual Studio:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\[X.Y]\  
  Languages\  
    File Extensions\  
      [FileExtension]\  
        (Default) = RG_SZ: [LanguageServiceGuid]

dove:

[X.Y] è un numero di versione di Visual Studio, ad esempio 8.0 o 8.0exp.
[FileExtension] è una stringa contenente l'estensione del file con il periodo iniziale; ad esempio "myext".
[LanguageServiceGuid] è il GUID del servizio linguistico; ad esempio , {B614A40A-80D9-4FAC-A6AD-FC2868FFF7CD}.

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

Attributo	Descrizione
ProvideLanguageServiceAttribute	Registra il servizio linguistico con Visual Studio e specifica quali funzionalità sono supportate.
ProvideLanguageExtensionAttribute	Associa un'estensione di file al servizio di lingua.
ProvideLanguageEditorOptionPageAttribute	Specifica un nodo di proprietà o una pagina per la finestra di dialogo Opzioni specifica del servizio linguistico.
ProvideLanguageCodeExpansionAttribute	Specifica le informazioni sulla posizione per supportare frammenti di codice nel servizio linguaggio.
ProvideServiceAttribute	Registra un servizio linguistico come servizio Visual Studio. Tutti i servizi forniti nel codice gestito usano questo attributo.

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

Usare questo attributo nel VSPackage per associare un'estensione di file al servizio linguistico.

Costruttori

ProvideLanguageExtensionAttribute(String, String)	Inizializza una nuova istanza dell'attributo ProvideLanguageExtensionAttribute utilizzando il GUID del servizio di linguaggio specificato.
ProvideLanguageExtensionAttribute(Type, String)	Inizializza una nuova istanza dell'attributo ProvideLanguageExtensionAttribute utilizzando la classe del linguaggio di servizio.

Proprietà

Extension	Restituisce l'estensione di file associata.
LanguageService	Restituisce il GUID del linguaggio.
TypeId	Eseguire l'override della proprietà TypeID per consentire alle classi derivate di RegistrationAttribute di funzionare con System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo elemento dovrà eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe. (Ereditato da RegistrationAttribute)

Metodi

GetPackageRegKeyPath(Guid)	Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Inserisce nel Registro di sistema l'estensione di file e il GUID del servizio di linguaggio.
Unregister(RegistrationAttribute+RegistrationContext)	Rimuove l'estensione di file e il GUID del servizio di linguaggio dal Registro di sistema.

Si applica a

Condividi tramite