ProvideLanguageCodeExpansionAttribute 클래스

정의

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

상속

Attribute

RegistrationAttribute

ProvideLanguageCodeExpansionAttribute

특성

AttributeUsageAttribute ComVisibleAttribute

예제

이 예제에서는 이 사용자 정의 특성을 사용하여 언어 서비스에 대한 코드 조각에 대한 지원을 등록하는 방법을 보여 줍니다.

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  
    {  
    }  
}  

설명

이 사용자 정의 특성(C#과 관련됨)은 Visual Studio에 코드 조각에 대한 언어 서비스의 지원을 등록하는 데 필요한 정보를 제공하는 데 사용됩니다. 이 특성에 지정된 값은 어셈블리에 메타데이터로 저장됩니다. 이 메타데이터는 나중에 regpkg.exe 프로그램(VSIP SDK의 일부)과 같은 프로그램에서 Visual Studio에 언어 서비스에 대해 알려주는 해당 레지스트리 키 및 항목을 만드는 데 사용됩니다.

의 영향을 받는 ProvideLanguageCodeExpansionAttribute 레지스트리 항목은 다음 레지스트리 키 아래에 있습니다.

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]  

위치:

• [X.Y] 는 Visual Studio 버전(예: 8.0Exp)입니다.

• [언어 이름] 은 언어의 이름입니다(클래스 생성자에 대한 두 번째 매개 변수에 ProvideLanguageCodeExpansionAttribute 지정된 대로).

• [언어 이름 리소스 ID] 는 표시 목적으로 사용되는 언어 이름의 리소스 ID이므로 지역화할 수 있습니다.

• [코드 조각 인덱스 파일 경로] 는 코드 조각의 위치를 설명하는 인덱스 파일의 전체 경로입니다.

• [언어 식별자] 는 모든 코드 조각과 코드 조각 인덱스 파일을 표시하는 데 사용되는 문자열입니다. 이 문자열은 코드 조각 집합을 특정 언어 서비스와 연결하는 데 사용됩니다.

• [코드 조각에 대한 경로] 인덱스 파일을 사용할 수 없는 경우 코드 조각을 검색할 반콜론으로 구분된 경로 목록입니다.

경로에는 Visual Studio에 설치된 루트 및 사용자의 내 문서 위치와 같은 위치를 가리키는 대체 변수가 포함될 수 있습니다. 이러한 대체 변수 에 대한 자세한 내용은 레거시 언어 서비스의 코드 조각 지원을 참조하세요.

클래스 생성자는 필요한 최소 매개 변수를 지정합니다. 사용자 정의 특성 클래스는 선택적 명명된 매개 변수도 지원합니다. 이러한 명명된 매개 변수는 필요한 매개 변수 다음에 생성자의 매개 변수 목록에 지정됩니다. get 및 set 연산자를 모두 지원하는 이 클래스의 모든 속성을 명명된 매개 변수로 지정할 수 있습니다. 이 예제에서는 명명된 매개 변수를 사용하는 방법을 보여 있습니다.

언어 서비스에는 다음과 같은 사용자 정의 특성이 사용됩니다.

상속자 참고

이 특성 클래스는 에서 상속할 수 없으므로 구현할 것이 없습니다.

호출자 참고

이 특성 클래스는 모든 클래스에 나타날 수 있지만 일반적으로 기본 VSPackage 클래스에 적용됩니다. 이 특성은 한 번만 표시되어야 합니다.

생성자

속성

메서드

적용 대상