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

Asocia una extensión de archivo a un servicio de lenguaje determinado.

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

Herencia: Attribute

RegistrationAttribute
ProvideLanguageExtensionAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En este ejemplo se muestra cómo asociar la extensión de archivo ".myext" a un servicio de lenguaje.

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  
{  
    [ProvideLanguageExtension(typeof(MyLanguageService), ".myext")]  
    public class MyLanguagePackage : Package  
    {  
    }  
}

Comentarios

Este atributo de C# definido por el usuario se usa para registrar con Visual Studio una extensión de archivo para un servicio de lenguaje determinado. Este atributo coloca la información necesaria en los metadatos del ensamblado que se recuperan y usan posteriormente por regpkg.exe. Todavía debe registrar el propio servicio de idioma; este atributo solo realiza la asociación entre la extensión de archivo y el servicio de lenguaje. Para obtener más información, consulte Registro de VSPackages.

Puede usar varias instancias de este atributo para asociar varias extensiones de archivo con el servicio de lenguaje.

La clave del Registro afectada por este atributo existe en la clave del Registro de Visual Studio:

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

donde:

[X.Y] es un número de versión de Visual Studio, como 8.0 o 8.0exp.
[FileExtension] es una cadena que contiene la extensión de archivo con el punto inicial; por ejemplo, "myext".
[LanguageServiceGuid] es el GUID del servicio de idioma; por ejemplo, {B614A40A-80D9-4FAC-A6AD-FC2868FFF7CD}.

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 con el servicio de lenguaje.
ProvideLanguageEditorOptionPageAttribute	Especifica un nodo de propiedad o una 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

Use este atributo en vsPackage para asociar una extensión de archivo con el servicio de lenguaje.

Constructores

ProvideLanguageExtensionAttribute(String, String)	Inicializa una instancia nueva del atributo ProvideLanguageExtensionAttribute, mediante el GUID del servicio de lenguaje especificado.
ProvideLanguageExtensionAttribute(Type, String)	Inicializa una instancia nueva del atributo ProvideLanguageExtensionAttribute, mediante el tipo de su clase de servicio de lenguaje.

Propiedades

Extension	Devuelve la extensión de archivo asociada.
LanguageService	Devuelve el lenguaje GUID.
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)	Coloca la extensión de archivo y el GUID del servicio de lenguaje en el Registro.
Unregister(RegistrationAttribute+RegistrationContext)	Quita la extensión de archivo y el GUID del servicio de lenguaje del Registro.

Se aplica a

Compartir a través de