Costruttore ProvideOptionPageAttribute (Type, String, String, Int16, Int16, Boolean)

Articolo
10/30/2012

Inizializza una nuova istanza di ProvideOptionPageAttribute che indica che una determinata classe implementa il supporto di configurazione dell'utente al package VS in base a una pagina di Opzioni degli strumenti .

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

Sintassi

'Dichiarazione
<BrowsableAttribute(False)> _
Public Sub New ( _
    pageType As Type, _
    categoryName As String, _
    pageName As String, _
    categoryResourceID As Short, _
    pageNameResourceID As Short, _
    supportsAutomation As Boolean _
)

[BrowsableAttribute(false)]
public ProvideOptionPageAttribute(
    Type pageType,
    string categoryName,
    string pageName,
    short categoryResourceID,
    short pageNameResourceID,
    bool supportsAutomation
)

Parametri

pageType
Tipo: System.Type
Type della classe che implementa la pagina di Opzioni degli strumenti .

categoryName
Tipo: System.String
Il nome non localizzata canonico della categoria della pagina di Opzioni degli strumenti .

pageName
Tipo: System.String
Il nome non localizzata canonico la sottocategoria della pagina di Opzioni degli strumenti .

categoryResourceID
Tipo: System.Int16
ID di risorsa localizzato della categoria della pagina di Opzioni degli strumenti .

pageNameResourceID
Tipo: System.Int16
ID di risorsa localizzato la sottocategoria della pagina di Opzioni degli strumenti .

supportsAutomation
Tipo: System.Boolean
Se true, la pagina di Opzioni degli strumenti è possibile accedere tramite il meccanismo di automazione di Visual Studio .

Note

Se l'automazione è supportata, i nomi non localizzata canonici di sottocategorie e di categoria vengono utilizzati per ottenere la raccolta di Properties di una pagina di Opzioni degli strumenti .Per ulteriori informazioni, vedere Utilizzando le pagine di opzioni.

Le informazioni di registrazione della pagina diOpzioni degli strumenti vengono create sotto le voci del Registro di sistema

ToolsOptionsPages
AutomationProperties (se il supporto di automazione è obbligatorio)

Questi vengono trovati in \Software\Microsoft\VisualStudio HKLM \ <versione> in cui <versione> è la versione di Visual Studio, ad esempio 8,0.

Le voci del Registro di sistema per le pagine Strumenti Opzioni sono:

ToolsOptionsPages \ <categoryName>

ToolsOptionsPages \ <categoryName> \ @=# <categoryResourceID>

ToolsOptionsPages \ <categoryName> \Package = {“}

ToolsOptionsPages \ <categoryName> \ <pageName>

ToolsOptionsPages \categoryName\pageName\@=#pageNameResourceID>

ToolsOptionsPages \ <categoryName> \ <pageName> \Package = {“}

ToolsOptionsPages \ <categoryName> \ <pageName> \Page ={“YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY„}

ToolsOptionsPages \ <categoryName> \ <pageName> \NoShowAllView =0/1

Se il supporto di automazione è specificato, le voci del Registro di sistema per AutomationProperties sono:

AutomationProperties \ <categoryName> \ <pageName>

AutomationProperties \ <categoryName> \ <pageName> \Name = <categoryName> . <pageName>

AutomationProperties \ <categoryName> \ <pageName> \Package = {“}

AutomationProperties \ <categoryName> \ <pageName> \ProfileSave =0/1

Esempi

Nell'esempio seguente viene mostrata la registrazione della pagina denominata “DesignerOptionsPage„ come fornire al pacchetto di “MyPackage„ il supporto della pagina di strumentiopzioni .Il package VS e la categoria GUID vengono ottenuti dall'attributo mediante reflection.

Le voci del Registro di sistema per DesignerOptionsPage sono:

ToolsOptionsPages \MyDesigner

ToolsOptionsPages \MyDesigner \ @=#1002

ToolsOptionsPages \MyDesigner\Package = {“}

ToolsOptionsPages \MyDesigner\OptionPage

ToolsOptionsPages \MyDesigner\OptionPage \ @=#1003

ToolsOptionsPages \MyDesigner\OptionPage\Package = {“}

ToolsOptionsPages \MyDesigner\OptionPage\Page ={“YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY„}

Nota il ToolsOptionsPages principale \MyDesigner\NoShowAllView non è impostato, poiché la proprietà NoShowAllView viene inizializzata a false.

Poiché la proprietà di SupportsAutomation è true, questi valori del Registro di sistema aggiuntivi vengono impostati:

AutomationProperties \MyDesigner\OptionPage

AutomationProperties \MyDesigner\OptionPage\Name=MyDesigner.OptionPage

AutomationProperties \MyDesigner\OptionPage\Package = {“}

AutomationProperties \MyDesigner\OptionPage\ProfileSave =1

Nota il ToolsOptionsPages principale \MyDesigner\ProfileSave è presente ed è impostato su 1 poiché la proprietà di SupportsProfiles è impostata su true.

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

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

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.

Vedere anche

Riferimenti

ProvideOptionPageAttribute Classe

Overload ProvideOptionPageAttribute

Spazio dei nomi Microsoft.VisualStudio.Shell

Condividi tramite