Konstruktor ProvideLanguageCodeExpansionAttribute —

Artykuł
10/27/2012

Inicjuje nowe wystąpienie ProvideLanguageCodeExpansionAttribute klasy.

Przestrzeń nazw: Microsoft.VisualStudio.Shell
Zestaw: Microsoft.VisualStudio.Shell.11.0 (w Microsoft.VisualStudio.Shell.11.0.dll)

Składnia

'Deklaracja
Public Sub New ( _
    languageService As Object, _
    languageName As String, _
    languageResourceId As Integer, _
    languageIdentifier As String, _
    pathToSnippetIndexFile As String _
)

public ProvideLanguageCodeExpansionAttribute(
    Object languageService,
    string languageName,
    int languageResourceId,
    string languageIdentifier,
    string pathToSnippetIndexFile
)

Parametry

languageService
Typ: System.Object
[w] Jest to ciąg zawierający identyfikator GUID lub typu, reprezentujące klasy, który implementuje usługę języka.Identyfikator GUID usługi język wywodzi się z tego ciągu lub typu.

languageName
Typ: System.String
[w] Nazwa języka.Ta nazwa jest używana w rejestrze dla nazwy klucza i wpis rejestru.

languageResourceId
Typ: System.Int32
[w] Identyfikator zasobu zlokalizowana wersja nazwa języka.Służy to obecnie nazwa języka w oknach dialogowych i innych elementów interfejsu użytkownika.

languageIdentifier
Typ: System.String
[w] Ciąg zawierający identyfikator specyficzne dla języka, który jest używany do znakowania i identyfikacji wstawki kodu programu.

pathToSnippetIndexFile
Typ: System.String
[w] Ciąg zawierający ścieżkę do urywki kodu indeks pliku dla tego języka.

Uwagi

Następujące pokazuje układ rejestru gdzie każdego z parametrów wymaganych jest używany.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\[X.Y]\Languages\
  Language Services\
    CodeExpansions\
      [languageName]\
        (Default) = reg_sz: [languageService]
         DisplayName  = reg_sz: [languageResourceId]
         IndexPath    = reg_sz: [pathToSnippetIndexFile]
         LangStringID = reg_sz: [languageIdentifier]
         Package      = reg_sz: [Package GUID]

[Identyfikator GUID pakietu] wartość są automatycznie uzyskiwane z klasy, która implementuje IVsPackage interfejsu w zestawie.

Oprócz wymaganych parametrów wymienionych w sekcji Parametry Konstruktora również akceptuje opcjonalne parametry nazwane po wymaganych parametrów.Jest to specjalny formularz obsługują tylko atrybuty zdefiniowane przez użytkownika.Odpowiadają one parametrów nazwanych właściwości publiczne dla tej klasy, które zarówno get i set operatorów.

Szczegółowe informacje na temat sposobu tworzenia i używany plik indeksu urywek zobacz Wsparcie dla wstawki kodu programu (w ramach pakietu zarządzanych).

Przykłady

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),            // Required
                            MyConstants.languageName,           // Required
                            MyConstants.languageNameResourceID, // Required
                            MyConstants.languageIdentifier,     // Required
                            MyConstants.snippetsIndexFilePath,  // Required
        // Optional code expansion properties
        SearchPaths = @"%InstallRoot%\MyLanguage\Snippets\%LCID%\Snippets;" +
                      @"\%MyDocs%\Code Snippets\MyLanguage\My Code Snippets";
                         )]

    class MyLanguagePackage
    {
    }
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..