Interfaccia IConfigureToolboxItem

  • Articolo

Consente di configurare ToolboxItem oggetti dinamicamente aggiunta di dati aggiuntivi alle proprietà degli elementi della casella degli strumenti del dizionario.Questi dati vengono serializzati come parte permanente dell'elemento della casella degli strumenti.

Spazio dei nomi:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)

Sintassi

'Dichiarazione
Public Interface IConfigureToolboxItem

public interface IConfigureToolboxItem

Il tipo IConfigureToolboxItem espone i seguenti membri.

Metodi

  Nome Descrizione
Metodo pubblico ConfigureToolboxItem Chiamato dal servizio della casella degli strumenti per configurare ToolboxItem oggetti.

In alto

Note

Tale interfaccia può essere distribuita in qualsiasi oggetto che può essere creato da cui non deriva Package.Il servizio della casella degli strumenti chiamerà ConfigureToolboxItem metodo quando un nuovo elemento della casella degli strumenti in primo luogo viene aggiunto alla casella degli strumenti.

le implementazioni di questa interfaccia devono essere registrate.La registrazione è costituito dai seguenti passaggi:

  1. Registrazione di un VSPackage particolare ad esempio fornire la configurazione dell'elemento della casella degli strumenti.

    Sotto il pacchetto gestito Framework, la registrazione viene effettuata da ProvideToolboxItemConfigurationAttribute.

    Nell'esempio riportato di seguito viene illustrato il package VS MyPackage registra ToolboxConfig classe come implementazione di IConfigureToolboxItem:

        [ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))]
    [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
    public class MyPackage : MSVSIP.Package {…}

  2. Registrare la configurazione dinamica di qualsiasi ToolboxItem oggetti dagli assembly specificati.

    Sotto il pacchetto gestito Framework, gli assembly di cui ToolboxItem gli oggetti vengono elaborati da un'implementazione di IConfigureToolboxItem sono specificate applicando ProvideAssemblyFilterAttribute all'implementazione di IConfigureToolboxItem.

    Nell'esempio riportato di seguito registra ToolboxConfig classe come fornisce il supporto di configurazione per tutti ToolboxItem oggetti in tutti gli assembly con Vsip spazio dei nomi.

        [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]
    public sealed class ToolboxConfig : IConfigureToolboxItem {…}

[!NOTA]

Questo attributo viene utilizzato l'id completa dell'assembly, inclusi un nome semplice, un numero di versione, una coppia di chiavi crittografiche e le impostazioni cultura supportate.Per ulteriori informazioni sull'identificazione assembly, vedere AssemblyName.“*„ Il carattere in una specifica viene utilizzato come carattere jolly.

registrare un'implementazione di IConfigureToolboxItem come parte di un package VS modifica le impostazioni del Registro di sistema in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration e HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID, dove <versione> è la versione di Visual Studio, ad esempio 8,0.

[!NOTA]

il percorso radice di HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> è possibile eseguire l'override con una radice alternativa quando la shell di Visual Studio viene inizializzato, o con DefaultRegistryRootAttribute.Per ulteriori informazioni sui percorsi principali alternati, vedere Opzioni della riga di comando (Visual Studio SDK) e DefaultRegistryRootAttribute.

Per ulteriori informazioni sul contenuto di queste voci del Registro di sistema, vedere Registrare le funzionalità di supporto della casella degli strumenti.

Note per gli implementatori

Implementare questa interfaccia quando è necessario modificare le caratteristiche di un oggetto Casella degli strumenti controllare in modo dinamico, ad esempio per rispondere alla presenza o all'assenza di determinate funzionalità o di oggetti.

I metodi di questa interfaccia vengono richiamati solo quando Casella degli strumenti viene inizializzato.

Visual Studio l'ambiente può essere necessario creare una nuova istanza delle implementazioni di IConfigureToolboxItem in qualsiasi momento.Accertarsi di avere:

  • Sempre utilizzo IConfigureToolboxItem come classe pubblica.

  • Non distribuire mai IConfigureToolboxItem sull'implementazione della classe Package o IVsPackage.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Shell

ToolboxItem

ProvideAssemblyFilterAttribute

Altre risorse

Casella degli strumenti (Visual Studio SDK)

Registrare le funzionalità di supporto della casella degli strumenti