ProvideLanguageCodeExpansionAttribute Sınıf

Tanım

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

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

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class ProvideLanguageCodeExpansionAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type ProvideLanguageCodeExpansionAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideLanguageCodeExpansionAttribute
Inherits RegistrationAttribute

Devralma

Attribute

RegistrationAttribute

ProvideLanguageCodeExpansionAttribute

Öznitelikler

AttributeUsageAttribute ComVisibleAttribute

Örnekler

Bu örnekte, bu kullanıcı tanımlı özniteliğin bir dil hizmeti için kod parçacıklarına yönelik desteği kaydetmek için nasıl kullanıldığı gösterilmektedir.

using Microsoft.VisualStudio.Shell;  

namespace MyLanguagePackage  
{  
    internal class MyConstants  
    {  
        public const string languageName           = "MyLanguage";  
        public const int    languageNameResourceID = 106;  
        public const string languageIdentifier     = "mylanguage";  
        public const string snippetsIndexFilePath   = @"%InstallRoot%\MyLanguage\SnippetsIndex.xml";  
    }  

    [ProvideCodeExpansion(typeof(MyLanguageService),  
                            MyConstants.languageName,  
                            MyConstants.languageNameResourceID,  
                            MyConstants.languageIdentifier,  
                            MyConstants.snippetsIndexFilePath,  
        // Optional code expansion properties  
        SearchPaths = @"%InstallRoot%\MyLanguage\Snippets\%LCID%\Snippets;" +  
                      @"\%MyDocs%\Code Snippets\MyLanguage\My Code Snippets";  
                         )]  

    class MyLanguagePackage  
    {  
    }  
}  

Açıklamalar

Bu kullanıcı tanımlı öznitelik (C#'ye özgüdür) Visual Studio'ya kod parçacıkları için bir dil hizmetinin desteğini kaydetmek için gerekli bilgileri sağlamak için kullanılır. Bu öznitelik tarafından belirtilen değerler derlemede meta veri olarak depolanır. Bu meta veriler daha sonra regpkg.exe programı (VSIP SDK'sının bir parçası) gibi bir program tarafından Visual Studio'ya dil hizmetini belirten ilgili kayıt defteri anahtarlarını ve girdilerini oluşturmak için kullanılır.

tarafından etkilenen ProvideLanguageCodeExpansionAttribute kayıt defteri girdileri aşağıdaki kayıt defteri anahtarı altında bulunur:

HKEY_LOCAL_MACHINE\  
  SOFTWARE\  
    Microsoft\  
      VisualStudio\  
        [X.Y]\  
          Languages\  
            CodeExpansions\  
              [language name]\  
                (Default)    = reg_sz: [Language Service GUID]  
                DisplayName  = reg_sz: [language name resource ID]  
                IndexPath    = reg_sz: [path to snippet index file]  
                Package      = reg_sz: [Package GUID]  
                LangStringID = reg_sz: [language identifier]  
                Paths\  
                  (Default)       = reg_sz:  
                  [language name] = reg_sz: [paths to snippets]  

Konum:

• [X.Y] , Visual Studio'nun sürümüdür, örneğin, 8.0Exp.

• [dil adı] , dilin adıdır (sınıf oluşturucusunun ikinci parametresinde ProvideLanguageCodeExpansionAttribute belirtildiği gibi).

• [dil adı kaynak kimliği] , görüntüleme amacıyla kullanılan dil adının kaynak kimliğidir ve bu nedenle yerelleştirilebilir.

• [kod parçacığı dizin dosyasının yolu] , kod parçacıklarının konumunu açıklayan dizin dosyasının tam yoludur.

• [dil tanımlayıcısı] , tüm kod parçacıklarını ve kod parçacıkları dizin dosyasını işaretlemek için kullanılan bir dizedir. Bu dize, bir kod parçacıkları kümesini belirli bir dil hizmetiyle ilişkilendirmek için kullanılır.

• [kod parçacıklarının yolları] Dizin dosyası kullanılamıyorsa kod parçacıklarını aramak için noktalı virgülle ayrılmış yol listesi.

Yollar, Visual Studio için yüklü kök ve kullanıcının Belgelerim konumu gibi konumlara işaret eden değiştirme değişkenleri içerebilir. Bu değiştirme değişkenlerinin ayrıntıları için bkz. Eski Dil Hizmetinde Kod Parçacıkları desteği.

Sınıf oluşturucu gerekli en düşük parametreleri belirtir. Kullanıcı tanımlı öznitelik sınıfı isteğe bağlı adlandırılmış parametreleri de destekler. Bu adlandırılmış parametreler, gerekli parametrelerden sonra oluşturucunun parametre listesinde belirtilir. Bu sınıfta hem get hem de set işleçlerini destekleyen tüm özellikler adlandırılmış parametre olarak belirtilebilir. Örnek, adlandırılmış parametrelerin nasıl kullanıldığını gösterir.

Dil hizmetleri için aşağıdaki kullanıcı tanımlı öznitelikler kullanılır:

Devralanlara Notlar

Bu öznitelik sınıfı öğesinden devralınamaz, bu nedenle uygulanacak bir şey yoktur.

Arayanlara Notlar

Bu öznitelik sınıfı genellikle birincil VSPackage sınıfınıza uygulanır, ancak herhangi bir sınıfta görüntülenebilir. Bu öznitelik yalnızca bir kez görünmelidir.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır