IConfigureToolboxItem Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet die Möglichkeit, ToolboxItem-Objekte durch das Hinzufügen zusätzlicher Daten zum Eigenschaftenwörterbuch des Toolbox-Elements dynamisch zu konfigurieren. Diese Daten werden dann als permanenter Teil des Toolboxelements serialisiert.
public interface class IConfigureToolboxItem
public interface class IConfigureToolboxItem
__interface IConfigureToolboxItem
public interface IConfigureToolboxItem
type IConfigureToolboxItem = interface
Public Interface IConfigureToolboxItem
Hinweise
Diese Schnittstelle kann für jedes Erstell Bare Objekt implementiert werden, das nicht von abgeleitet ist Package . Der Toolbox Dienst ruft die- ConfigureToolboxItem Methode auf, wenn ein neues Toolbox Element zum ersten Mal der Toolbox hinzugefügt wird.
Implementierungen dieser Schnittstelle müssen registriert werden. Die Registrierung besteht aus den folgenden Schritten:
Registrieren eines bestimmten VSPackages als Bereitstellen der Toolbox Element Konfiguration.
Im Managed Package Framework wird diese Registrierung von durchgeführt ProvideToolboxItemConfigurationAttribute .
Das folgende Beispiel zeigt, wie das VSPackage
MyPackagedie-ToolboxConfigKlasse als Implementierung von registriert IConfigureToolboxItem :[ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))] [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")] public class MyPackage : MSVSIP.Package {…}Die dynamische Konfiguration aller ToolboxItem Objekte wird durch angegebene Assemblys registriert.
Im Managed Package Framework werden die Assemblys, deren ToolboxItem Objekte von einer Implementierung von verarbeitet werden, IConfigureToolboxItem durch Anwenden ProvideAssemblyFilterAttribute auf diese Implementierung von angegeben IConfigureToolboxItem .
Im folgenden Beispiel wird die-
ToolboxConfigKlasse als Bereitstellung der Konfigurations Unterstützung für alle- ToolboxItem Objekte in allen Assemblys mit dem-VsipNamespace registriert.[ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")] public sealed class ToolboxConfig : IConfigureToolboxItem {…}
Hinweis
Dieses Attribut verwendet die vollständige assemblykennung, einschließlich eines einfachen Namens, einer Versionsnummer, eines kryptografieschlüsselpaars und einer unterstützten Kultur. Weitere Informationen über Assemblykennung finden Sie unter AssemblyName. Das Zeichen "*" in einer Spezifikation wird als Platzhalter verwendet.
Wenn Sie eine Implementierung von IConfigureToolboxItem als Teil eines VSPackage registrieren HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration , werden die Registrierungs Einstellungen unter und geändert HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID , wobei <Version> die Version von ist 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-Shell initialisiert wird, oder mit DefaultRegistryRootAttribute . Weitere Informationen zu alternativen Stamm Pfaden finden Sie unter Befehls Zeilenschalter und DefaultRegistryRootAttribute .
Weitere Informationen zum Inhalt dieser Registrierungseinträge finden Sie unter Registrieren von Funktionen der Toolbox Unterstützung.
Hinweise für Ausführende
Implementieren Sie diese Schnittstelle, wenn Sie die Merkmale eines Toolbox -Steuer Elements dynamisch ändern müssen, um beispielsweise darauf zu reagieren, dass bestimmte Features oder Objekte vorhanden sind oder nicht.
Die Methoden dieser Schnittstelle werden nur aufgerufen, wenn die Toolbox initialisiert wird.
Visual StudioMöglicherweise muss die Umgebung jederzeit eine neue Instanz von Implementierungen von erstellen IConfigureToolboxItem . Stellen Sie Folgendes sicher: : Implementieren Sie immer IConfigureToolboxItem als öffentliche Klasse.
-Niemals IConfigureToolboxItem in einer Klasse implementieren, die Package oder implementiert IVsPackage .
Methoden
| ConfigureToolboxItem(ToolboxItem) |
Wird vom Toolboxdienst aufgerufen, um ToolboxItem-Objekte zu konfigurieren. |