ProvideLanguageExtensionAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidruží příponu souboru ke službě konkrétního jazyka.
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
- Dědičnost
- Atributy
Příklady
Tento příklad ukazuje, jak přidružit příponu souboru ".myext" ke službě jazyka.
Poznámka
Visual C# umožňuje zkrácenou formu uživatelem definovaného atributu vyřazením části "Attribute" názvu. Tato zkrácená forma se používá v tomto a všech ostatních příkladech v této třídě.
using Microsoft.VisualStudio.Shell;
namespace MyLanguagePackage
{
[ProvideLanguageExtension(typeof(MyLanguageService), ".myext")]
public class MyLanguagePackage : Package
{
}
}
Poznámky
Tento uživatelem definovaný atribut jazyka C# slouží k registraci přípony souboru pro konkrétní službu jazyka v sadě Visual Studio. Tento atribut vloží potřebné informace do metadat sestavení, která jsou později načtena a používána regpkg.exe. Stále musíte zaregistrovat samotnou jazykovou službu; tento atribut pouze vytváří přidružení mezi příponou souboru a službou jazyka. Další informace najdete v tématu Registrace balíčků VSPackage.
K přidružení více přípon souborů ke službě jazyka můžete použít více instancí tohoto atributu.
Klíč registru ovlivněný tímto atributem existuje pod klíčem registru sady Visual Studio:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\[X.Y]\
Languages\
File Extensions\
[FileExtension]\
(Default) = RG_SZ: [LanguageServiceGuid]
kde:
[X.Y] je číslo verze sady Visual Studio, například 8.0 nebo 8.0exp.
[FileExtension] je řetězec obsahující příponu souboru s počáteční tečkou; například "myext".
[LanguageServiceGuid] je identifikátor GUID vaší jazykové služby. například
{B614A40A-80D9-4FAC-A6AD-FC2868FFF7CD}
.
Následující uživatelem definované atributy se používají pro jazykové služby:
Atribut | Popis |
---|---|
ProvideLanguageServiceAttribute | Zaregistruje službu jazyka v sadě Visual Studio a určí podporované funkce. |
ProvideLanguageExtensionAttribute | Přidruží příponu souboru ke službě jazyka. |
ProvideLanguageEditorOptionPageAttribute | Určuje uzel vlastnosti nebo stránku pro dialogové okno Možnosti specifické pro službu jazyka. |
ProvideLanguageCodeExpansionAttribute | Určuje informace o umístění pro podporu fragmentů kódu ve službě jazyka. |
ProvideServiceAttribute | Zaregistruje službu jazyka jako službu sady Visual Studio. Tento atribut používají všechny služby poskytované ve spravovaném kódu. |
Poznámky pro dědice
Tuto třídu atributu nelze zdědit, takže není co implementovat.
Poznámky pro volající
Pomocí tohoto atributu v balíčku VSPackage přidružte příponu souboru ke službě jazyka.
Konstruktory
ProvideLanguageExtensionAttribute(String, String) |
Inicializuje novou instanci atributu ProvideLanguageExtensionAttribute pomocí zadaného identifikátoru GUID služby jazyka. |
ProvideLanguageExtensionAttribute(Type, String) |
Inicializuje novou instanci atributu ProvideLanguageExtensionAttribute pomocí typu třídy služby jazyka. |
Vlastnosti
Extension |
Vrátí přidruženou příponu souboru. |
LanguageService |
Vrátí identifikátor GUID jazyka. |
TypeId |
Přepište vlastnost TypeID, aby odvozené třídy RegistrationAttribute fungovaly se System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut odvozený z tohoto atributu bude muset přepsat tuto vlastnost pouze v případě, že potřebuje lepší kontrolu nad instancemi, které lze použít na třídu. (Zděděno od RegistrationAttribute) |
Metody
GetPackageRegKeyPath(Guid) |
Získá cestu registru (vzhledem ke kořenovému adresáři registru aplikace) VSPackage. (Zděděno od RegistrationAttribute) |
Register(RegistrationAttribute+RegistrationContext) |
Vloží příponu souboru a identifikátor GUID služby jazyka do registru. |
Unregister(RegistrationAttribute+RegistrationContext) |
Odebere z registru příponu souboru a identifikátor GUID služby jazyka. |