Condividi tramite


ProvideOptionPageAttribute Classe

Definizione

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à
Attributi

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
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