Interfejs IConfigureToolboxItem

Artykuł
10/27/2012

Zapewnia możliwość konfigurowania ToolboxItem obiektów dynamicznie, przez dodanie dodatkowych danych do elementu Przybornika właściwości słownika.Te dane jest następnie zaszeregowane w stałą częścią element przybornika.

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

Składnia

'Deklaracja
Public Interface IConfigureToolboxItem

public interface IConfigureToolboxItem

Typ IConfigureToolboxItem uwidacznia następujące elementy członkowskie.

Metody

	Nazwa	Opis
	ConfigureToolboxItem	Wywołana przez usługę przybornika, aby skonfigurować ToolboxItem obiektów.

Początek

Uwagi

Ten interfejs można zaimplementować tego obiektu, który nie pochodzi od Package.Usługa przybornik będzie wywoływać ConfigureToolboxItem metodę, gdy nowy element przybornika jest pierwszym dodaje się do przybornika.

Implementacje interfejsu musi być zarejestrowany.Rejestracja składa się z następujących czynności:

Rejestrowanie szczegółowe VSPackage jako zapewniające konfiguracji towaru w przyborniku.

W ramach pakietu zarządzane, to rejestracja ta jest wykonywana przez ProvideToolboxItemConfigurationAttribute.

Przykład poniżej pokazuje jak VSPackage MyPackage rejestry ToolboxConfig klasy jako implementacja IConfigureToolboxItem:
```
    [ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))]
    [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
    public class MyPackage : MSVSIP.Package {…}
```
Rejestrowanie dynamiczną konfigurację wszystkich ToolboxItem obiekty według określonych zestawów.

W ramach zarządzane pakietu, zespoły którego ToolboxItem obiekty są przetwarzane przez implementację IConfigureToolboxItem są określone przez zastosowanie ProvideAssemblyFilterAttribute do wykonania tego IConfigureToolboxItem.

Przykład poniżej rejestrów ToolboxConfig klasy jako zapewniające obsługę konfiguracji wszystkich ToolboxItem obiektów w wszystkie zespoły z Vsip obszaru nazw.
```
    [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]
    public sealed class ToolboxConfig : IConfigureToolboxItem {…}
```

[!UWAGA]

Ten atrybut używa identyfikacji pełnego zestawu, włączając w to prosta nazwa, numer wersji, pary kluczy kryptograficznych i obsługiwaną kulturą.Aby uzyskać więcej informacji na temat identyfikacji Zgromadzenia, zobacz AssemblyName."*" Znak w specyfikacji jest traktowana jako symbol wieloznaczny.

Rejestrowanie implementacja IConfigureToolboxItem jako część VSPackage Modyfikuje ustawienia rejestru, pod HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration i HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID, gdzie <Version> jest wersją Visual Studio, na przykład 8.0.

[!UWAGA]

Ścieżka katalogu głównego z HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> może być zastąpiona z alternatywnego głównego podczas inicjowania powłoki programu Visual Studio lub z DefaultRegistryRootAttribute.Aby uzyskać więcej informacji na główny alternatywnej ścieżki, zobacz Przełączniki wiersza polecenia (Visual Studio SDK) i DefaultRegistryRootAttribute.

Aby uzyskać więcej informacji na temat zawartości tych wpisów rejestru, zobacz Rejestrowanie funkcji obsługi przybornika.

Uwagi dotyczące implementacji

Implementował ten interfejs, gdy trzeba zmodyfikować właściwości Przybornik kontroli dynamicznie, na przykład, aby odpowiedzieć na obecność lub brak niektórych funkcji lub obiektów.

Metody interfejsu są wywoływane tylko wtedy, gdy Przybornik jest inicjowany.

Visual Studio Środowisko może być konieczne utworzenie nowej instancji implementacje IConfigureToolboxItem w dowolnym momencie.Zapewnić, że: