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

  • Articolo

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

Vedere anche

Riferimenti

ProvideOptionPageAttribute Classe

Overload ProvideOptionPageAttribute

Spazio dei nomi Microsoft.VisualStudio.Shell