Pomoc techniczna dotycząca ustawień użytkownika

Pakiet VSPackage może zdefiniować jedną lub więcej kategorii ustawień, które są grupami zmiennych stanu, które są utrwalane, gdy użytkownik wybierze polecenie Importuj/Eksportuj Ustawienia w menu Narzędzia. Aby włączyć tę trwałość, użyj interfejsów API ustawień w zestawie Visual Studio SDK.

Wpis rejestru nazywany niestandardowym punktem Ustawienia i identyfikatorEM GUID definiuje kategorię ustawień pakietu VSPackage. Pakiet VSPackage może obsługiwać wiele kategorii ustawień, z których każdy jest definiowany przez punkt Ustawienia niestandardowy.

• Implementacje ustawień opartych na zestawach międzyoperacyjnych (przy użyciu interfejsuIVsUserSettings) powinny utworzyć niestandardowy punkt Ustawienia, edytując rejestr lub używając skryptu rejestratora (plik rgs). Aby uzyskać więcej informacji, zobacz Tworzenie skryptów rejestratora.

• Kod korzystający z programu Managed Package Framework (MPF) powinien utworzyć niestandardowe punkty Ustawienia, dołączając element do ProvideProfileAttribute pakietu VSPackage dla każdego punktu niestandardowego Ustawienia.

  Jeśli pojedynczy pakiet VSPackage obsługuje kilka punktów niestandardowych Ustawienia, każdy punkt Ustawienia niestandardowy jest implementowany przez oddzielną klasę, a każdy z nich jest rejestrowany przez unikatowe wystąpienie ProvideProfileAttribute klasy. W związku z tym ustawienia implementowania klasy mogą obsługiwać więcej niż jedną kategorię ustawień.

Szczegóły wpisu rejestru punktów niestandardowych Ustawienia

Niestandardowe punkty Ustawienia są tworzone we wpisie rejestru w następującej lokalizacji: HKLM\Software\Microsoft\VisualStudio\<Version>\User Ustawienia\<CSPName>, gdzie <CSPName> jest nazwą niestandardowego Ustawienia Point obsługiwanego przez pakiet VSPackage, a< wersja> jest wersją programu Visual Studio, na przykład 8.0.

Uwaga

Ścieżka główna HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> może zostać zastąpiona alternatywnym katalogiem głównym podczas inicjowania zintegrowanego środowiska projektowego (IDE) programu Visual Studio. Aby uzyskać więcej informacji, zobacz Przełączniki wiersza polecenia.

Struktura wpisu rejestru jest pokazana poniżej:

HKLM\Software\Microsoft\VisualStudio\<Version>\User Ustawienia\

<CSPName>= s '#12345'

Pakiet = "{XXXXXX XXXX XXXX XXXXXXXXX}"

Category = "{RRRRRRRR RRRRRR RRRRRRRRRRRRRRYYYY}"

ResourcePackage = "{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZ}"

AlternateParent = CategoryName

Nazwisko	Typ	Dane	opis
(Domyślna)	REG_SZ	Nazwa niestandardowego punktu Ustawienia	Nazwa <CSPName>klucza , jest nielokalizowaną nazwą niestandardowego punktu Ustawienia. W przypadku implementacji opartych na programie MPF nazwa klucza jest uzyskiwana przez połączenie categoryName argumentów i objectName konstruktora ProvideProfileAttribute z categoryName_objectNameelementem . Klucz może być pusty lub może zawierać identyfikator odwołania do zlokalizowanego ciągu w satelicie DLL. Ta wartość jest uzyskiwana z argumentu objectNameResourceID do konstruktora ProvideProfileAttribute .
Pakiet	REG_SZ	Identyfikator GUID	Identyfikator GUID pakietu VSPackage implementujący punkt niestandardowy Ustawienia. Implementacje oparte na programie MPF przy użyciu ProvideProfileAttribute klasy używają argumentu konstruktora objectType zawierającego elementy i odbicie pakietu VSPackage Type , aby uzyskać tę wartość.
Kategoria	REG_SZ	Identyfikator GUID	Identyfikator GUID identyfikujący kategorię ustawień. W przypadku implementacji opartych na zestawach międzyoperacyjnych ta wartość może być dowolnie wybranym identyfikatorem GUID, który środowisko IDE programu Visual Studio przekazuje do ExportSettings metod i ImportSettings . Wszystkie implementacje tych dwóch metod powinny zweryfikować ich argumenty identyfikatora GUID. W przypadku implementacji opartych na programie MPF ten identyfikator GUID jest uzyskiwany przez Type klasę implementując mechanizm ustawień programu Visual Studio.
ZasóbPackage	REG_SZ	Identyfikator GUID	Opcjonalny. Ścieżka do biblioteki DLL satelitarnej zawierającej zlokalizowane ciągi, jeśli implementacja pakietu VSPackage nie dostarcza ich. Narzędzie MPF używa odbicia w celu uzyskania poprawnego zasobu VSPackage, więc ProvideProfileAttribute klasa nie ustawia tego argumentu.
Alternatywnego rodzica	REG_SZ	Nazwa folderu na stronie Opcje narzędzi zawierającej ten niestandardowy punkt Ustawienia.	Opcjonalny. Tę wartość należy ustawić tylko wtedy, gdy implementacja ustawień obsługuje strony Opcje narzędzi, które używają mechanizmu trwałości w zestawie SDK programu Visual Studio, a nie mechanizmu w modelu automatyzacji w celu zapisania stanu. W takich przypadkach wartość w kluczu AlternateParent jest sekcją topictopic.sub-topic ciągu używanego do identyfikowania określonej strony NarzędziaOpcje . Na przykład dla strony "TextEditor.Basic" ToolsOptions wartość Alternatywnaparent będzie wynosić "TextEditor". Podczas ProvideProfileAttribute generowania niestandardowego punktu Ustawienia jest on taki sam jak nazwa kategorii.