Metodo Package.ParseToolboxResource (TextReader, ResourceManager)
Analizza una risorsa incorporata del testo del formato appropriato per informazioni sui cui elementi devono essere aggiunte a Casella degli strumenti.
Spazio dei nomi: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)
Sintassi
'Dichiarazione
Protected Sub ParseToolboxResource ( _
resourceData As TextReader, _
localizedCategories As ResourceManager _
)
protected void ParseToolboxResource(
TextReader resourceData,
ResourceManager localizedCategories
)
Parametri
- resourceData
Tipo: System.IO.TextReader
Il lettore di testo che fornisce i dati dell'elemento della casella degli strumenti in formato è descritto nei commenti.
- localizedCategories
Tipo: System.Resources.ResourceManager
Un gestore di risorse che consente ricerche localizzata nomi per le categorie fornite nei dati delle risorse.Questo parametro può essere null, in questo caso i nomi di categoria direttamente utilizzati.
Note
La risorsa di testo che un VSPackage analizza utilizzando ParseToolboxResource deve essere incorporata in un assembly e in uno spazio dei nomi accessibili a VSPackage.
Le risorse del testo da aggiungere a un assembly fare clic con il pulsante destro del mouse sul progetto dell'assembly, la selezione aggiungere e su nuovo elemento.Dal menu di nuovo elemento , quindi selezionare file di testo.Una volta che il file di testo è stato aggiunto al progetto, impostare la proprietà di operazione di compilazione a risorsa incorporata.
Questo metodo può essere utilizzato per aggiungere elementi alla casella degli strumenti automaticamente.I dati delle risorse vengono passati al parametro di resourceData e sono costituiti da un file di testo con il formato seguente:
; Comment
[CategoryName]
<class name>, <assembly name>
Il nome della categoria può essere localizzato tramite il gestore di risorse di localizedCategories passato al metodo.Il parametro di localizedCategories può essere null, in questo caso i nomi di categoria non sono localizzati.
Il nome dell'assembly può essere un nome completo o un nome parziale.Se un nome parziale viene passato, l'assembly recentemente effettuato con tale nome parziale viene caricato.
Per elaborare i nomi di assembly, ParseToolboxResource, directory di ricerca solo specificate in digitare la voce del Registro di sistema HKEY_CURRENT_USER \Software\Microsoft\VisualStudio \ <versione> \AssemblyFolders, dove <versione> è il numero di versione della versione di Visual Studio, ad esempio 8,0)
[!NOTA]
Il percorso radice HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\VisualStudio \ <versione> è possibile eseguire l'override con alternanza la radice quando la shell di Visual Studio viene inizializzato, o l'utilizzo di DefaultRegistryRootAttribute.Per ulteriori informazioni vedere Opzioni della riga di comando (Visual Studio SDK) e DefaultRegistryRootAttribute.
Il formato delle sottochiavi in HKEY_CURRENT_USER \Software\Microsoft\VisualStudio \ <versione> \AssemblyFolders viene
nome |
tipo |
Dati |
descrizione |
|---|---|---|---|
<Valore> |
REG_SZ |
Stringa contenente il percorso completo di una directory che dovrà contenere gli assembly utilizzato da Visual Studio. |
Il nome della chiave, <Valore> , può essere qualsiasi valore purché sia univoco.I dati della chiave contiene il percorso completo di una directory che contiene gli assembly da trovare da ParseToolboxResource |
Il package VS che necessita di utilizzare ParseToolboxResource necessario registrarsi con l'ambiente di Visual Studio come fornire gli elementi di Casella degli strumenti .
L'attributo ProvideToolboxItemsAttribute necessario applicare all'implementazione del package VS di Package.A seconda dell'implementazione del package VS ProvideToolboxFormatAttribute e ProvideToolboxItemConfigurationAttribute può essere richiesto.
Per ulteriori informazioni sulla creazione di un provider dell'elemento di Casella degli strumenti , vedere Sviluppo avanzate del controllo della casella degli strumenti.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.