ProvideOptionPageAttribute 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.12.40392

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 a oggetti indipendenti per consentire agli utenti di configurare VSPackage tramite una pagina Opzioni strumenti personalizzata.

public ref class ProvideOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

public ref class ProvideOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideOptionPageAttribute : Microsoft.VisualStudio.Shell.ProvideOptionDialogPageAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideOptionPageAttribute = class
    inherit ProvideOptionDialogPageAttribute

Public NotInheritable Class ProvideOptionPageAttribute
Inherits ProvideOptionDialogPageAttribute

Ereditarietà: Attribute

RegistrationAttribute

ProvideOptionDialogPageAttribute
ProvideOptionPageAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente viene applicata un'istanza di ProvideOptionPageAttribute a un'implementazione di VSPackage per registrare la classe DesignerOptionsPage, derivata da DialogPage, come specificare VSPackage con una pagina Opzioni strumenti .

Le classi derivate da DialogPage vengono fornite con un'implementazione predefinita delle funzionalità delle impostazioni di Visual Studio, che possono essere sostituite. L'IDE usa questo supporto delle impostazioni di Visual Studio se, come nell'esempio, ProvideProfileAttribute viene applicato all'implementazione di VSPackage. Per altre informazioni sul supporto delle impostazioni di Visual Studio, vedere Estensione delle impostazioni utente e opzioni.

using Microsoft.VisualStudio.Shell;  
namespace Example  
{  
[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]   
[ProvideOptionPage(typeof(DesignerOptionsPage), "MyDesigner", "OptionPage", 1000, 1001, true)]   
[ProvideProfileAttribute(typeof(DesignerOptionsPage), "MyDesigner", "OptionPage", 1002, 1003, true)]  
[ProvideProfileAttribute(typeof(PersistCurrentDesign), "MyDesigner","CurrentDesign", 1004, 1005, false)]  
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
public class MyPackage : Package  
{  
//Implementation here  
}  

[Guid("YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY")]  
internal class DesignerOptionsPage: DialogPage {  
//Implementation here  
}  

[Guid("ZZZZZZZZ-ZZZZ-ZZZZ-ZZZZ-ZZZZZZZZZZZZ")]  
internal class PersistCurrentDesign: IProfileManager {  
//Implementation here  
}

Commenti

Note per gli implementatori

Applicare l'oggetto ProvideOptionPageAttribute alle classi che implementano un PACCHETTO VSPackage. Questo attributo consente di registrare che un oggetto indipendente specifico fornisce agli utenti di VSPackage l'accesso alla configurazione tramite una pagina Opzioni strumenti personalizzata.

Contesto attributo


Si applica a	I pacchetti VSPackage consentono la configurazione tramite pagine di opzioni degli strumenti personalizzate implementate tramite il framework di pacchetti DialogPage gestiti o usando il codice di Visual Studio SDK.
Ripetibile	Sì
Attributi richiesti	DefaultRegistryRootAttribute
Attributi non validi	Nessuno

Note per i chiamanti

Questo attributo viene usato solo per scopi di registrazione e non influisce sul comportamento di runtime del codice.

Registra ProvideOptionPageAttribute una determinata classe che implementa IProfileManager o DialogPage fornisce un particolare supporto VSPackage per rendere persistente la parte o lo stato di VSPackage tramite il meccanismo delle impostazioni di Visual Studio. Le informazioni sullo stato mantenute dalla classe di implementazione vengono definite categoria di impostazioni di Visual Studio e la relativa voce di definizione nel Registro di sistema viene definita punto impostazioni personalizzate.

Nota

Quando viene caricata una pagina Opzioni strumenti personalizzati basata su Managed Package Framework, l'IDE crea un'istanza dell'oggetto registrato dall'implementazione ProvideOptionPageAttribute . Il supporto della pagina Opzioni degli strumenti del framework del pacchetto gestito deve essere implementato nel proprio oggetto e non in VSPackage stesso.

Per altre informazioni sulla creazione e l'applicazione di istanze di ProvideOptionPageAttribute, vedere l'esempio seguente e ProvideOptionPageAttribute.

Costruttori

ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, Int32)	Crea un'istanza di una nuova istanza di ProvideOptionPageAttribute.
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String)	Crea un'istanza di una nuova istanza di ProvideOptionPageAttribute.
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String[])	Crea un'istanza di una nuova istanza di ProvideOptionPageAttribute.

Proprietà

CategoryDescriptionResourceId	ID di una risorsa contenente la descrizione localizzata della categoria padre della pagina. Questa proprietà viene usata solo se SupportsAutomation == true e SupportsProfiles == true. La descrizione localizzata viene visualizzata nella procedura guidata delle impostazioni di importazione/esportazione.
CategoryName	Ottiene il nome non localizzato canonico della categoria Opzioni strumenti.
CategoryPackageGuid	ID del pacchetto proprietario della categoria in cui viene registrata questa pagina. Se questo non è impostato, si presuppone che il pacchetto sia quello a cui viene applicato questo attributo. Questa proprietà viene usata solo se SupportsAutomation == true e SupportsProfiles == true. Generare questa operazione da un Guid con Guid.ToString("B").
CategoryResourceID	Ottiene l'ID risorsa categoria per una pagina Opzioni strumenti.
DescriptionResourceId	ID di una risorsa contenente la descrizione localizzata della pagina. Questa proprietà viene usata solo se SupportsAutomation == true e SupportsProfiles == true. La descrizione localizzata viene visualizzata nella procedura guidata delle impostazioni di importazione/esportazione.
IsInUnifiedSettings	Ottiene o imposta un valore che indica se le impostazioni in questa pagina sono state caricate in Impostazioni unificata tramite la creazione di una nuova registrazione. Se true, la pagina è nascosta quando le impostazioni unificate sono abilitate in modo che le impostazioni non siano duplicate.
IsServerAware	Ottiene o imposta un valore che indica se l'interfaccia utente di questa pagina mostra le impostazioni sincronizzate con il server in uno scenario client-server connesso usando ISettingsManager3 o un'API con funzionalità simili.
Keywords	Ottiene le parole chiave ricercabili per questa pagina di opzioni. Ogni parola chiave può essere una stringa letterale, un nome di risorsa/ID (preceduto da "@"/"#") che punta a una singola parola chiave o a un nome/ID risorsa (preceduto da "@"/"#") che punta a un elenco delimitato da punti e virgola delle parole chiave.
NoShowAllView	Ottiene o imposta se vengono visualizzate pagine opzioni degli strumenti aggregati.
PageName	Ottiene il nome non localizzato canonico della pagina Opzioni strumenti.
PageNameResourceId	Ottiene l'ID risorsa del nome della pagina. (Ereditato da ProvideOptionDialogPageAttribute)
PageType	Ottiene il tipo della pagina. (Ereditato da ProvideOptionDialogPageAttribute)
ProfileMigrationType	Imposta il tipo di migrazione del profilo.
ProvidesLocalizedCategoryName	Determina se il pacchetto ha le risorse localizzate per il nome della categoria.
Sort	Ordine di ordinamento per la pagina dell'opzione. Le pagine delle opzioni vengono confrontate nell'ordine seguente: `1. The General page 2. Pages with a Sort value, sorted from low to high. 3. Pages without a Sort value, sorted alphabetically.`
SupportsAutomation	Ottiene se un'implementazione della pagina Opzioni strumenti supporta l'automazione.
SupportsProfiles	Ottiene o imposta se un'implementazione della pagina Opzioni strumenti usa il meccanismo delle impostazioni di Visual Studio per rendere persistente lo stato.
TypeId	Ottiene l'istanza corrente di ProvideOptionPageAttribute.
UnifiedSettingsCategoryMoniker	Per le pagine con IsInUnifiedSettings = false, ottiene o imposta il moniker della categoria padre nella gerarchia Impostazioni unificata. Questo può essere un moniker già esistente o uno che esiste più un altro '.' -delimitato segmento. Se quest'ultimo viene creata una nuova categoria denominata da CategoryResourceID nella gerarchia Impostazioni unificata e questa pagina viene inserita in esso. In caso contrario, questa pagina viene inserita nella categoria esistente.
VisibilityCmdUIContexts	Elenco delimitato da punti e virgola dei GUID UIContext. La pagina dell'opzione è visibile quando qualsiasi UIContext nell'elenco è attivo. Se questa opzione non è specificata, la pagina dell'opzione è sempre visibile.

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 la pagina Opzioni strumenti.
Unregister(RegistrationAttribute+RegistrationContext)	Rimuove la chiave della pagina Opzioni strumenti dal Registro di sistema.

Si applica a

Condividi tramite