Konstruktor ProvideOptionPageAttribute — (Type, String, String, Int16, Int16, Boolean)

Artykuł
10/27/2012

Inicjuje nowe wystąpienie ProvideOptionPageAttribute wskazujące konkretnej klasy implementuje obsługi konfiguracji użytkownika w oparciu o VSPackage Opcje narzędzia strony.

Przestrzeń nazw: Microsoft.VisualStudio.Shell
Zestaw: Microsoft.VisualStudio.Shell.11.0 (w Microsoft.VisualStudio.Shell.11.0.dll)

Składnia

'Deklaracja
<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
)

Parametry

pageType
Typ: System.Type
Type Wykonawczych klasy Opcje narzędzia strony.

categoryName
Typ: System.String
Nazwa kanoniczna niezlokalizowanej Opcje narzędzia strony kategorii.

pageName
Typ: System.String
Nazwa kanoniczna niezlokalizowanej Opcje narzędzia stronę podkategorii.

categoryResourceID
Typ: System.Int16
Identyfikator zasobów zlokalizowanych z Opcje narzędzia strony kategorii.

pageNameResourceID
Typ: System.Int16
Identyfikator zasobów zlokalizowanych z Opcje narzędzia stronę podkategorii.

supportsAutomation
Typ: System.Boolean
Jeśli wartość true, Opcje narzędzia strony mogą być udostępniane za pośrednictwem Visual Studio mechanizmu automatyzacji.

Uwagi

Jeżeli obsługiwana jest automatyzacji, kanoniczny niezlokalizowanej nazwy kategorii i podkategorii są używane do uzyskania Opcje narzędzia strony Properties kolekcji.Aby uzyskać więcej informacji, zobacz Przy użyciu opcji stron.

Narzędzia Opcje informacje na stronie rejestracji utworzony na podstawie wpisów rejestru

ToolsOptionsPages
AutomationProperties (Jeśli wymagana jest obsługa automatyzacji)

Te znajdują się pod HKLM\Software\Microsoft\VisualStudio\<Version> gdzie <Version> jest wersją Visual Studio, na przykład 8.0.

Wpisy rejestru dla stron opcje narzędzia są:

ToolsOptionsPages\<categoryName>

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

ToolsOptionsPages\<categoryName>\Package={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

ToolsOptionsPages\<categoryName>\<pageName>

ToolsOptionsPages\<categoryName>\<pageName>\ @ = #< pageNameResourceID>

ToolsOptionsPages\<categoryName>\<pageName>\Package={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

ToolsOptionsPages\<categoryName>\<pageName>\Page={"YYYYYYYY-rrrr-rrrr-rrrr-YYYYYYYYYYYY"}

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

Jeżeli określono obsługi automatyzacji, wpisy rejestru dla AutomationProperties są:

AutomationProperties\<categoryName>\<pageName>

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

AutomationProperties\<categoryName>\<pageName>\Package={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

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

Przykłady

W poniższym przykładzie pokazano rejestracji stronę o nazwie "DesignerOptionsPage" jako zapewniające pakiet "Mojpakiet" z NarzędziaOpcje strony pomocy technicznej.VSPackage i kategorii identyfikatory GUID są uzyskiwane przez atrybut przez odbicie.

Wpisy rejestru dla DesignerOptionsPage są:

ToolsOptionsPages\MyDesigner

ToolsOptionsPages\MyDesigner\@=#1002

ToolsOptionsPages\MyDesigner\Package ={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

ToolsOptionsPages\MyDesigner\OptionPage

ToolsOptionsPages\MyDesigner\OptionPage\@=#1003

ToolsOptionsPages\MyDesigner\OptionPage\Package ={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

ToolsOptionsPages\MyDesigner\OptionPage\Page ={"YYYYYYYY-rrrr rrrr rrrr YYYYYYYYYYYY"}

Uwaga ToolsOptionsPages\MyDesigner\NoShowAllView nie jest ustawiony klucz, ponieważ właściwość NoShowAllView inicjowana jest false.

Ponieważ SupportsAutomation jest właściwość true, są ustawione wartości te dodatkowe klucze rejestru:

AutomationProperties\MyDesigner\OptionPage

AutomationProperties\MyDesigner\OptionPage\Name=MyDesigner.OptionPage

AutomationProperties\MyDesigner\OptionPage\Package ={"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}

AutomationProperties\MyDesigner\OptionPage\ProfileSave = 1

Uwaga klucza ToolsOptionsPages\MyDesigner\ProfileSave jest obecnie i ustaw wartość 1, ponieważ SupportsProfiles właściwość jest ustawiona na 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
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

ProvideOptionPageAttribute Klasa

Przeciążenie ProvideOptionPageAttribute

Przestrzeń nazw Microsoft.VisualStudio.Shell

Udostępnij za pośrednictwem