ProvideToolboxItemsAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Pacchetto:: Microsoft.VisualStudio.Shell.15.0 v17.11.40262

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Applicare questo attributo alle classi che implementano VSPackage per dichiarare se offrono un set di elementi alla casella degli strumenti di Visual Studio.

public ref class ProvideToolboxItemsAttribute : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public class ProvideToolboxItemsAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)>]
type ProvideToolboxItemsAttribute = class
    inherit RegistrationAttribute

Public Class ProvideToolboxItemsAttribute
Inherits RegistrationAttribute

Ereditarietà: Attribute

RegistrationAttribute
ProvideToolboxItemsAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente gli attributi applicati alla classe MyPackage indicano che supporta la versione 1 degli elementi della casella degli strumenti di con due formati "CF_XMLCODE" e "InPlaceMenuEditorMenu".

[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]  
[ProvideToolboxItems(true, 1)]  
[ProvideToolboxFormat("CF_XMLCODE")]  
[ProvideToolboxFormat("InPlaceMenuEditorMenu")]  
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
internal sealed class MyPackage : Package

Commenti

Contesto attributo


Si applica a	Classi che forniscono PACCHETTI VSPackage implementando IVsPackage, Package.
Ripetibile	No
Attributi richiesti	ProvideToolboxFormatAttribute
Attributi non validi	Nessuno

Applicare questo attributo a una Packageclasse derivata da -o a una classe che implementa IVsPackage che è necessaria per consentire agli utenti di trascinare gli oggetti dati di questo formato, forniti dalla classe , nella casella degli strumenti. Questa classe di implementazione deve gestire le notifiche di rilascio.

Questo attributo viene usato solo a scopo di registrazione e non influisce sul comportamento del codice in fase di esecuzione.

A seconda degli argomenti specificati nel relativo costruttore, questo attributo può indicare che un VSPackage non fornisce elementi della casella degli strumenti . Se l'attributo ProvideToolboxFormatAttribute viene aggiunto a una classe per indicare che fornisce elementi della casella degli strumenti , è necessario aggiungere anche una o più istanze di ProvideToolboxFormatAttribute .

Questo attributo usa ProvideToolboxFormatAttribute per registrare un VSPackage come specificare gli elementi della casella degli strumenti di un determinato formato.

Se questo attributo specifica che vengono forniti gli elementi della casella degli strumenti , il VSPackage deve gestire gli ToolboxInitialized eventi e ToolboxUpgraded .

Qualsiasi VSPackage che usa questo attributo deve fornire un gestore per gli ToolboxInitialized eventi e ToolboxUpgraded .

Costruttori

ProvideToolboxItemsAttribute(Int32)	Crea una nuova istanza di ProvideToolboxItemsAttribute che indica se una classe che implementa un VSPackage fornisce elementi della casella degli strumenti.
ProvideToolboxItemsAttribute(Int32, Boolean)	Inizializza una nuova istanza di ProvideToolboxItemsAttribute per la versione specificata.

Proprietà

NeedsCallBackAfterReset	Se si imposta su true, verrà forzato un evento ToolboxInitialized dopo ogni reimpostazione della casella degli strumenti. Questa opzione può essere usata durante lo sviluppo del pacchetto per forzare la casella degli strumenti a chiedere l'elenco di elementi al pacchetto ogni volta (nel caso in cui sia stata modificata). Per i prodotti spediti, è consigliabile lasciarlo false in modo che la cache possa essere usata per prestazioni migliori. Alcuni scenari, ad esempio l'elenco di elementi che non possono essere salvati in modo permanente nella cache, potrebbero dover impostare questo flag su true
TypeId	Eseguire l'override della proprietà TypeID per consentire alle classi derivate RegistrationAttribute di usare System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo deve eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe. (Ereditato da RegistrationAttribute)
Version	Proprietà che restituisce la versione degli elementi della casella degli strumenti forniti da un VSPackage.

Metodi

GetPackageRegKeyPath(Guid)	Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra un VSPackage come provider di elementi della casella degli strumenti per i formati specificati quando viene chiamato da uno strumento di registrazione esterno, ad esempio regpkg.exe. Per altre informazioni, vedere Registrazione di PACCHETTI VSPackage.
Unregister(RegistrationAttribute+RegistrationContext)	Inverte le modifiche apportate dal metodo di Register(RegistrationAttribute+RegistrationContext) al Registro di sistema.

Si applica a

Condividi tramite