ProvideLanguageExtensionAttribute Klasse

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell

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

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

Paket:: Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ordnet einem bestimmten Sprachdienst eine Dateierweiterung zu.

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

Vererbung: Attribute

RegistrationAttribute
ProvideLanguageExtensionAttribute

Attribute: AttributeUsageAttribute

Beispiele

In diesem Beispiel wird gezeigt, wie die Dateierweiterung ".myext" einem Sprachdienst zugeordnet wird.

Hinweis

Visual C# ermöglicht die Kurzform eines benutzerdefinierten Attributs, indem der Teil des Namens "Attribut" gelöscht wird. Diese Kurzform wird in diesem und allen anderen Beispielen in dieser Klasse verwendet.

using Microsoft.VisualStudio.Shell;  

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

Hinweise

Dieses benutzerdefinierte C#-Attribut wird verwendet, um bei Visual Studio eine Dateierweiterung für einen bestimmten Sprachdienst zu registrieren. Dieses Attribut fügt die erforderlichen Informationen in die Metadaten der Assembly ein, die später abgerufen und von regpkg.exe verwendet werden. Sie müssen den Sprachdienst selbst noch registrieren. Dieses Attribut stellt nur die Zuordnung zwischen der Dateierweiterung und dem Sprachdienst her. Weitere Informationen finden Sie unter Registrieren von VSPackages.

Sie können mehrere Instanzen dieses Attributs verwenden, um Ihrem Sprachdienst mehrere Dateierweiterungen zuzuordnen.

Der Registrierungsschlüssel, der von diesem Attribut betroffen ist, befindet sich unter dem Registrierungsschlüssel von Visual Studio:

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

Dabei gilt:

[X.Y] ist eine Visual Studio-Versionsnummer, z. B. 8.0 oder 8.0exp.
[FileExtension] ist eine Zeichenfolge, die die Dateierweiterung mit dem führenden Zeitraum enthält. beispiel: "myext".
[LanguageServiceGuid] ist die GUID Ihres Sprachdiensts. beispiel: {B614A40A-80D9-4FAC-A6AD-FC2868FFF7CD}.

Die folgenden benutzerdefinierten Attribute werden für Sprachdienste verwendet:

attribute	BESCHREIBUNG
ProvideLanguageServiceAttribute	Registriert den Sprachdienst bei Visual Studio und gibt an, welche Features unterstützt werden.
ProvideLanguageExtensionAttribute	Ordnet dem Sprachdienst eine Dateierweiterung zu.
ProvideLanguageEditorOptionPageAttribute	Gibt einen Eigenschaftenknoten oder eine Seite für das Dialogfeld Optionen an, das für den Sprachdienst spezifisch ist.
ProvideLanguageCodeExpansionAttribute	Gibt Standortinformationen an, um Codeausschnitte im Sprachdienst zu unterstützen.
ProvideServiceAttribute	Registriert einen Sprachdienst als Visual Studio-Dienst. Alle Dienste, die in verwaltetem Code bereitgestellt werden, verwenden dieses Attribut.

Hinweise für Vererber

Diese Attributklasse kann nicht von geerbt werden, sodass nichts implementiert werden muss.

Hinweise für Aufrufer

Verwenden Sie dieses Attribut in Ihrem VSPackage, um Ihrem Sprachdienst eine Dateierweiterung zuzuordnen.

Konstruktoren

ProvideLanguageExtensionAttribute(String, String)	Initialisiert eine neue Instanz des ProvideLanguageExtensionAttribute-Attributs unter Verwendung der angegebenen Sprachdienst-GUID.
ProvideLanguageExtensionAttribute(Type, String)	Initialisiert eine neue Instanz des ProvideLanguageExtensionAttribute-Attributs unter Verwendung des Typs der Sprachdienstklasse.

Eigenschaften

Extension	Gibt die zugeordnete Dateierweiterung zurück.
LanguageService	Gibt die Sprachen-GUID zurück.
TypeId	Überschreiben Sie die TypeID-Eigenschaft, damit die abgeleiteten RegistrationAttribute-Klassen mit System.ComponentModel.TypeDescriptor.GetAttributes(...) arbeiten können. Ein von diesem abgeleitetes Attribut muss diese Eigenschaft nur überschreiben, wenn es eine bessere Steuerung für die Instanzen benötigt, die auf eine Klasse angewendet werden können. (Geerbt von RegistrationAttribute)

Methoden

GetPackageRegKeyPath(Guid)	Ruft den Registrierungspfad (relativ zum Registrierungsstamm der Anwendung) des VSPackages ab. (Geerbt von RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Setzt die Dateierweiterungs- und Sprachdienst-GUID in die Registrierung ein.
Unregister(RegistrationAttribute+RegistrationContext)	Entfernt die Dateierweiterungs- und Sprachdienst-GUID aus der Registrierung.

Gilt für:

Freigeben über