Beibehalten von Einstellungen
VSPackage wird möglicherweise eine oder mehrere Gruppen, die Einstellungskategorien sind die Variablen Zustand beibehalten werden, wenn ein Benutzer den Einstellungen importieren und exportieren Befehl für das Extras Menü ausgewählt wird. Um diese Dauerhaftigkeit zu aktivieren, verwenden Sie die Einstellungen Visual Studio SDKAPIs aus.
Ein Registrierungseintrag, der als ein benutzerdefinierter Einstellungs-Punkt bezeichnet, eine GUID und VSPackages eine Einstellungskategorie definiert. VSPackage kann Simultanbühne Kategorien, jede unterstützen, die von einem benutzerdefinierten Einstellungs-Punkt definiert ist.
Implementierungen von Einstellungen auf Grundlage von Interop-Assemblys sind (unter Verwendung der IVsUserSettings-Schnittstelle) sollten benutzerdefinierten Einstellungs-Punkt erstellen, indem sie die Registrierung bearbeiten oder ein Registrierungsstellen von Skripts verwenden (RGS-Datei). Weitere Informationen finden Sie unter Erstellen von Registrierungsstellen-Skripten.
Code, der das verwaltete Paketframework (MPF) sollte benutzerdefinierte Einstellungs-Punkte erstellen, indem ProvideProfileAttribute zu VSPackages für jeden benutzerdefinierten Einstellungs-Punkt angefügt werden.
Wenn einzelnes VSPackage mehrere benutzerdefinierte Einstellungs-Punkte unterstützt, wird jeder benutzerdefinierte Einstellungs-Punkt durch eine separate Klasse implementiert, und jedes Element wird durch eine eindeutige Instanz der ProvideProfileAttribute-Klasse registriert. Daher können die Einstellungen, die Klasse implementieren, mehr als eine Einstellungskategorie unterstützen.
Benutzerdefinierte Einstellungs-Punkt-Registrierungseintrags-Details
Benutzerdefinierte Einstellungs-Punkte werden in einem Registrierungseintrag an folgendem Speicherort: HKLM \ Software \ Microsoft \ VisualStudio \ <Version> \ UserSettings \<CSPName>, in dem <CSPName> der Name des benutzerdefinierten Einstellungs-Punkts VSPackage ist, unterstützt und <Version> ist die Version von Visual Studio, z. B. 8.0.
Hinweis
Der Stammpfad von HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ VisualStudio \ <Version> kann mit einem alternativen Stamm überschrieben werden, wenn die Visual Studio integrierte Entwicklungsumgebung (IDE) initialisiert wird.Weitere Informationen finden Sie unter Befehlszeilenschalter (Visual Studio SDK).
Die Struktur des Registrierungseintrags wird im Folgenden gezeigt:
HKLM \ Software \ Microsoft \ VisualStudio \ <Version> \ \ UserSettings
<CSPName>= „s“ #12345
Paket „=“ {}
Kategorie = „{YYYYYY YYYY YYYY YYYY YYYYYYYYY}“
ResourcePackage = „{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZZZ}“
AlternateParent = CategoryName
Name |
Typ |
Daten |
Beschreibung |
|---|---|---|---|
(Standard) |
REG_SZ |
Name des benutzerdefinierten Einstellungs-Punkts |
Der Schlüsselname, <CSPName> nicht gefunden, lautet der Name des benutzerdefinierten Einstellungs-Punkts. Für Implementierungen auf MPF, wird der Schlüsselname abgerufen, indem die categoryName und objectName-Argumente des Konstruktors in ProvideProfileAttributecategoryName_objectNamekombiniert. Der Schlüssel kann leer sein, oder sie kann die Bezugs-ID auf die lokalisierten Zeichenfolgen in einer Satelliten-DLL enthalten. Dieser Wert wird vom objectNameResourceID-Argument an den Konstruktor ProvideProfileAttribute abzurufen. |
Package |
REG_SZ |
GUID |
Die GUID VSPackages, das den benutzerdefinierten Einstellungs-Punkt implementiert. Implementierungen auf MPF mithilfe der ProvideProfileAttribute-Klasse, verwenden das objectType-Argument des Konstruktors, der Type VSPackages und Reflektion, um diesen Wert zu erhalten. |
Kategorie |
REG_SZ |
GUID |
GUID, die die Einstellungskategorie identifiziert. Für Implementierungen auf Interopassemblys, kann dieser Wert eines willkürlich ausgewähltes GUID vorliegen, das das Visual Studio IDE zum ExportSettings und ImportSettings-Methode übergeben wird. Alle Implementierungen dieser beiden Methoden sollten ihre GUID-Argumente überprüfen. Für Implementierungen auf Grundlage von GUIDs, wird dieses MPF Type der Klasse erhalten, die den Mechanismus zur Einstellungen Visual Studio implementiert. |
ResourcePackage |
REG_SZ |
GUID |
Optional. Pfad zur Satellite-DLL, die lokalisierte Zeichenfolgen enthält, wenn implementierende VSPackage sie nicht bereitstellt. MPF verwendet Reflektion, um die richtige Ressource VSPackages. Daher wird die ProvideProfileAttribute-Klasse keine dieses Argument festgelegt. |
AlternateParent |
REG_SZ |
Name des Ordners mit der Seite Optionen im Menü Extras, die diesen benutzerdefinierten Einstellungs-Punkt enthält. |
Optional. Sie müssen diesen Wert festlegen, wenn nur eine Implementierung der Einstellungen Extras/Optionen Seiten, die den Mechanismus zur Persistenz in Visual Studio SDK verwenden, sondern als Mechanismus im Automatisierungsmodell unterstützt, um den Zustand zu speichern. Weitere Informationen finden Sie unter Registrieren benutzerdefinierter Optionsseiten. In solchen Fällen wird der Wert in der AlternateParent-Taste der topic-Abschnitt der topic.sub-topic Zeichenfolge, die verwendet wird, um die bestimmte Seite ExtrasOptionen zu identifizieren. Für die Seite "TextEditor.Basic" z. B ExtrasOptionen wird der Wert von AlternateParent"TextEditor"sein. Wenn ProvideProfileAttribute den benutzerdefinierten Einstellungs-Punkt generiert, wird er mit dem Kategorienamen. |
Siehe auch
Aufgaben
Gewusst wie: und exportieren mithilfe von Interop-Assemblys
Gewusst wie: Verwendungs-Interopassemblys, um Einstellungen zu importieren
Referenz
Erstellen von Registrierungsstellen-Skripten
Erstellen von Registrierungsstellen-Skripten