ProvideOptionPageAttribute Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zastosuj ten atrybut do niezależnych obiektów, aby umożliwić użytkownikom konfigurowanie pakietów VSPackage za pomocą niestandardowej strony Opcje narzędzi.
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
- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie wystąpienie ProvideOptionPageAttribute programu jest stosowane do implementacji pakietu VSPackage w celu zarejestrowania klasy DesignerOptionsPage
, która pochodzi z DialogPageklasy , jako udostępniania pakietu VSPackage na stronie Opcje narzędzi .
Klasy pochodne DialogPage są dostarczane z domyślną implementacją funkcji ustawień programu Visual Studio, które można zastąpić. Środowisko IDE korzysta z tej obsługi ustawień programu Visual Studio, jeśli, podobnie jak w przykładzie, ProvideProfileAttribute jest stosowane do implementacji pakietu VSPackage. Aby uzyskać więcej informacji na temat obsługi ustawień programu Visual Studio, zobacz Rozszerzanie ustawień użytkownika i opcji.
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
}
Uwagi
Uwagi dotyczące implementacji
Zastosuj do ProvideOptionPageAttribute klas implementowania pakietu VSPackage. Ten atrybut umożliwia zarejestrowanie, że określony niezależny obiekt zapewnia użytkownikom pakietu VSPackage dostęp do konfiguracji za pośrednictwem niestandardowej strony Opcje narzędzi .
Kontekst atrybutu
Dotyczy | Pakiety VSPackage umożliwiają konfigurację za pośrednictwem niestandardowych stron Opcji narzędzi zaimplementowanych za pośrednictwem programu Managed Package Framework DialogPage lub przy użyciu kodu zestawu SDK programu Visual Studio. |
Powtarzalność | Tak |
Wymagane atrybuty | DefaultRegistryRootAttribute |
Nieprawidłowe atrybuty | Brak |
Uwagi dotyczące wywoływania
Ten atrybut jest używany tylko do celów rejestracji i nie ma wpływu na zachowanie środowiska uruchomieniowego kodu.
Rejestruje ProvideOptionPageAttribute daną klasę implementując IProfileManager lub DialogPage jako zapewniającą określoną obsługę pakietu VSPackage na potrzeby utrwalania części lub całego stanu pakietu VSPackage za pośrednictwem mechanizmu ustawień programu Visual Studio. Informacje o stanie utrwalane przez klasę implementowania są określane jako kategoria ustawień programu Visual Studio, a jej wpis definiujący w rejestrze jest określany jako punkt ustawień niestandardowych.
Uwaga
Po załadowaniu strony Opcje narzędzi niestandardowych opartych na programie Managed Package Framework środowisko IDE tworzy wystąpienie obiektu zarejestrowanego przez ProvideOptionPageAttribute jego implementację. Obsługa strony Narzędzia struktury pakietów zarządzanych powinna być implementowana na własnym obiekcie, a nie na samym pakiecie VSPackage.
Aby uzyskać więcej informacji na temat tworzenia i stosowania wystąpień programu ProvideOptionPageAttribute, zobacz poniższy przykład i ProvideOptionPageAttribute.
Konstruktory
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, Int32) |
Tworzy wystąpienie nowego wystąpienia elementu ProvideOptionPageAttribute. |
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String) |
Tworzy wystąpienie nowego wystąpienia elementu ProvideOptionPageAttribute. |
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String[]) |
Tworzy wystąpienie nowego wystąpienia elementu ProvideOptionPageAttribute. |
Właściwości
CategoryDescriptionResourceId |
Identyfikator zasobu zawierającego zlokalizowany opis kategorii nadrzędnej strony. Ta właściwość jest używana tylko w przypadku wartości SupportsAutomation == true i SupportsProfiles == true. Zlokalizowany opis jest wyświetlany w kreatorze ustawień importu/eksportu. |
CategoryName |
Pobiera kanoniczną nielokalizowaną nazwę kategorii Opcje narzędzi. |
CategoryPackageGuid |
Identyfikator pakietu, który jest właścicielem kategorii, w której zarejestrowano tę stronę. Jeśli to nie jest ustawione, zakłada się, że pakiet jest tym, do którego jest stosowany ten atrybut. Ta właściwość jest używana tylko w przypadku wartości SupportsAutomation == true i SupportsProfiles == true. Wygeneruj to na podstawie identyfikatora Guid.ToString("B"). |
CategoryResourceID |
Pobiera identyfikator zasobu kategorii dla strony Opcje narzędzi. |
DescriptionResourceId |
Identyfikator zasobu zawierającego zlokalizowany opis strony. Ta właściwość jest używana tylko w przypadku wartości SupportsAutomation == true i SupportsProfiles == true. Zlokalizowany opis jest wyświetlany w kreatorze ustawień importu/eksportu. |
IsInUnifiedSettings |
Pobiera lub ustawia wartość wskazującą, czy ustawienia na tej stronie zostały dołączone do ujednoliconych ustawień podczas tworzenia nowej rejestracji. Jeśli to prawda, strona jest ukryta po włączeniu ujednoliconych ustawień, więc jego ustawienia nie są zduplikowane. |
IsServerAware |
Pobiera lub ustawia wartość wskazującą, czy interfejs użytkownika tej strony pokazuje ustawienia synchronizowane z serwerem w scenariuszu połączonym klient-serwer przy użyciu protokołu ISettingsManager3 lub interfejsu API z podobną funkcjonalnością. |
Keywords |
Pobiera wyszukiwane słowa kluczowe dla tej strony opcji. Każde słowo kluczowe może być ciągiem literału, nazwą zasobu/identyfikatorem (poprzedzonym znakiem "@"/"#") wskazującym jedno słowo kluczowe lub nazwą/identyfikatorem zasobu (poprzedzoną znakiem "@"/"#") wskazującą listę słów kluczowych rozdzielanych średnikami. |
NoShowAllView |
Pobiera lub ustawia, czy są wyświetlane zagregowane strony Opcje narzędzi. |
PageName |
Pobiera kanoniczną nielokalizowaną nazwę strony Opcje narzędzi. |
PageNameResourceId |
Pobiera identyfikator zasobu nazwy strony. (Odziedziczone po ProvideOptionDialogPageAttribute) |
PageType |
Pobiera typ strony. (Odziedziczone po ProvideOptionDialogPageAttribute) |
ProfileMigrationType |
Ustawia typ migracji profilu. |
ProvidesLocalizedCategoryName |
Określa, czy pakiet ma zlokalizowane zasoby dla nazwy kategorii. |
Sort |
Kolejność sortowania dla strony opcji. Strony opcji są sortowane w następującej kolejności:
|
SupportsAutomation |
Pobiera, czy implementacja strony Opcje narzędzi obsługuje automatyzację. |
SupportsProfiles |
Pobiera lub ustawia, czy implementacja strony Opcje narzędzi używa mechanizmu ustawień programu Visual Studio do utrwalania stanu. |
TypeId |
Pobiera bieżące wystąpienie elementu ProvideOptionPageAttribute. |
UnifiedSettingsCategoryMoniker |
W przypadku stron z IsInUnifiedSettings = false, pobiera lub ustawia moniker kategorii nadrzędnej w hierarchii Ujednolicone ustawienia. Może to być moniker, który już istnieje, lub jeden, który istnieje plus jeden dodatkowy "". -rozdzielany segment. Jeśli ta ostatnia kategoria o nazwie by CategoryResourceID zostanie utworzona w hierarchii ujednoliconych ustawień i zostanie wstawiona ta strona. W przeciwnym razie ta strona zostanie wstawiona w istniejącej kategorii. |
VisibilityCmdUIContexts |
Rozdzielana średnikami lista identyfikatorów GUID interfejsu użytkownikaContext. Strona opcji jest widoczna, gdy dowolny element UIContext na liście jest aktywny. Jeśli ta opcja nie jest określona, strona opcji jest zawsze widoczna. |
Metody
GetPackageRegKeyPath(Guid) |
Pobiera ścieżkę rejestru (względem katalogu głównego rejestru aplikacji) pakietu VSPackage. (Odziedziczone po RegistrationAttribute) |
Register(RegistrationAttribute+RegistrationContext) |
Rejestruje stronę Opcje narzędzi. |
Unregister(RegistrationAttribute+RegistrationContext) |
Usuwa klucz strony Opcje narzędzi z rejestru. |