Klasa ProvideOptionPageAttribute

Artykuł
10/27/2012

Stosuje się ten atrybut do niezależnych obiektów, aby użytkownicy mogli konfigurować VSPackages przy użyciu niestandardowej Opcje narzędzia strony.

Hierarchia dziedziczenia

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.ProvideOptionDialogPageAttribute
        Microsoft.VisualStudio.Shell.ProvideOptionPageAttribute

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

Składnia

'Deklaracja
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True, Inherited := True)> _
Public NotInheritable Class ProvideOptionPageAttribute _
    Inherits ProvideOptionDialogPageAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
public sealed class ProvideOptionPageAttribute : ProvideOptionDialogPageAttribute

Typ ProvideOptionPageAttribute uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean)	Inicjuje nowe wystąpienie ProvideOptionPageAttribute wskazujące konkretnej klasy implementuje obsługi konfiguracji użytkownika w oparciu o VSPackage Opcje narzędzia strony.
	ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, Int32)
	ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String)
	ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, array<String[])

Początek

Właściwości

	Nazwa	Opis
	CategoryName	Pobiera nazwę kanoniczną niezlokalizowanej Opcje narzędzia strony kategorii.
	CategoryResourceID	Pobiera identyfikator zasobu kategorii Opcje narzędzia strony.
	Keywords
	NoShowAllView	Pobiera lub ustawia, czy zagregowane Opcje narzędzia stron są wyświetlane.
	PageName	Pobiera nazwę kanoniczną niezlokalizowanej Opcje narzędzia strony.
	PageNameResourceId	Pobiera identyfikator zasobu nazwy strony. (Odziedziczone z ProvideOptionDialogPageAttribute).
	PageType	Pobiera typu strony. (Odziedziczone z ProvideOptionDialogPageAttribute).
	ProfileMigrationType	Ustawia typ migracji profilu.
	ProvidesLocalizedCategoryName
	SupportsAutomation	Pobiera czy Opcje narzędzia implementacja strony obsługuje automatyzacji.
	SupportsProfiles	Zwraca lub ustawia czy Opcje narzędzia strona używa realizacji Visual Studio mechanizmu ustawienia do jego stanu utrwalenia.
	TypeId	Pobiera bieżące wystąpienie ProvideOptionPageAttribute. (Zastępuje RegistrationAttribute.TypeId).

Początek

Metody

	Nazwa	Opis
	Equals	Infrastruktura. Zwraca wartość, która wskazuje, czy to wystąpienie jest równa określonego obiektu. (Odziedziczone z Attribute).
	GetHashCode	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone z Attribute).
	GetType	Pobiera Type bieżącej instancji. (Odziedziczone z Object).
	IsDefaultAttribute	Gdy zastąpiony w klasie pochodnej, wskazuje, czy wartość to wystąpienie jest wartością domyślną dla klasy pochodnej. (Odziedziczone z Attribute).
	Match	Gdy zastąpiony w klasie pochodnej, zwraca wartość wskazującą, czy to wystąpienie jest równa określonego obiektu. (Odziedziczone z Attribute).
	Register	Rejestry Opcje narzędzia strony. (Zastępuje RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)).
	ToString	Zwraca ciąg, który reprezentuje bieżącego obiektu. (Odziedziczone z Object).
	Unregister	Usuwa Opcje narzędzia stronę klucza z rejestru. (Zastępuje RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)).

Początek

Jawne implementacje interfejsu

	Nazwa	Opis
	_Attribute.GetIDsOfNames	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłki. (Odziedziczone z Attribute).
	_Attribute.GetTypeInfo	Pobiera informacje o typie dla obiektu, który można uzyskać informacji o typie dla interfejsu. (Odziedziczone z Attribute).
	_Attribute.GetTypeInfoCount	Pobiera numer typu informacji interfejsów, że obiekt zawiera (0 lub 1). (Odziedziczone z Attribute).
	_Attribute.Invoke	Zapewnia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone z Attribute).

Początek

Uwagi

Uwagi do implementacji

Stosuje się ProvideOptionPageAttribute do klasy wykonania VSPackage.Ten atrybut pozwala zarejestrować się, że określonego obiektu niezależnych zapewnia użytkownikom VSPackage konfiguracji dostępu za pośrednictwem niestandardowy Opcje narzędzia strony.

Atrybutu kontekstu

Stosuje się do	VSPackages Zezwalaj na konfigurację poprzez niestandardowe Opcje narzędzia stron realizowane poprzez zarządzane pakiet ramach 's DialogPage lub za pomocą Visual Studio SDK kod.
Powtarzalne	Tak
Wymagane atrybuty	DefaultRegistryRootAttribute
Nieprawidłowe atrybuty	Brak

Uwagi do wywoływania

Ten atrybut jest używany tylko do celów rejestracji i nie wpływa na zachowanie wykonywania kodu.

ProvideOptionPageAttribute Rejestry danej klasy wykonawczych IProfileManager lub DialogPage jako przewidujących szczególne wsparcie VSPackage utrzymujących części lub całości VSPackage's Państwo poprzez Visual Studio mechanizmu ustawienia.Informacje o stanie są zachowywane przez zaimplementowanie klasy jest określone jako Visual Studio ustawienia kategorii i jego definiujących wpis w rejestrze jest określane jako punkt ustawienia niestandardowe.

[!UWAGA]

Kiedy ramy pakiet zarządzanych oparte niestandardowe Opcje narzędzia załadowana strona, IDE tworzy wystąpienie obiektu, zarejestrowanych przez ProvideOptionPageAttribute jako jej wykonania.Zarządzane w ramach pakietu Opcje narzędzia stronę pomocy technicznej powinny zostać wdrożone na swój własny obiekt, a nie na VSPackage, sam.

Aby uzyskać więcej informacji na temat tworzenia i stosowania wystąpienia ProvideOptionPageAttribute, patrz przykład poniżej i ProvideOptionPageAttribute.

Przykłady

W przykładzie poniżej wystąpienie ProvideOptionPageAttribute jest stosowany do wykonania VSPackage zarejestrować klasy DesignerOptionsPage, która wywodzi się z DialogPage, jako zapewniające VSPackage z Opcje narzędzia strony.

Pochodną klasy DialogPage są dostarczane z realizacji domyślne Visual Studio ustawienia funkcji, która może być zastąpiona.IDE korzysta z tego Visual Studio obsługa ustawień if, jak w przykładzie, ProvideProfileAttribute jest stosowany do wykonania VSPackage.Aby uzyskać więcej informacji na Visual Studio ustawienia obsługi, zobacz Opcje i ustawienia użytkownika.

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
}

Bezpieczeństwo wątku

Wszystkie publiczne static (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Wystąpienia elementów członkowskich nie dają gwarancji bezpieczeństwa wątków.