ProvideOptionPageAttribute Sınıf

Başvuru

Tanım

Ad Alanı:: Microsoft.VisualStudio.Shell

Bütünleştirilmiş Kod:: Microsoft.VisualStudio.Shell.14.0.dll

Bütünleştirilmiş Kod:: Microsoft.VisualStudio.Shell.15.0.dll

Paket:: Microsoft.VisualStudio.Shell.15.0 v17.11.40262

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kullanıcıların özel Araçlar Seçenekleri sayfası aracılığıyla VSPackage'ları yapılandırmasına izin vermek için bu özniteliği bağımsız nesnelere uygulayın.

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

Devralma: Attribute

RegistrationAttribute

ProvideOptionDialogPageAttribute
ProvideOptionPageAttribute

Öznitelikler: AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte, VSPackage'a bir Araç Seçenekleri sayfası sağlayarak sınıfından DialogPagetüretilen sınıfını DesignerOptionsPagekaydetmek için vsPackage uygulamasına bir örneği ProvideOptionPageAttribute uygulanır.

'den DialogPage türetilen sınıflar, geçersiz kılınabilen Visual Studio ayarları işlevinin varsayılan bir uygulamasıyla sağlanır. Örnekte ProvideProfileAttribute olduğu gibi VSPackage uygulamasına uygulandıysa, IDE bu Visual Studio ayarları desteğini kullanır. Visual Studio ayarları desteği hakkında daha fazla bilgi için bkz. Kullanıcı Ayarlarını ve Seçeneklerini Genişletme.

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  
}

Açıklamalar

Uygulayıcılar için Notlar

ProvideOptionPageAttribute bir VSPackage uygulayan sınıflara uygulayın. Bu öznitelik, belirli bir bağımsız nesnenin VSPackage kullanıcılarına özel Araçlar Seçenekleri sayfası aracılığıyla yapılandırma erişimi sağladığını kaydetmeyi sağlar.

Öznitelik Bağlamı


Şunlara uygulanır	VSPackage'lar, Yönetilen Paket Çerçevesi DialogPage aracılığıyla veya Visual Studio SDK kodu kullanılarak uygulanan özel Araç Seçenekleri sayfaları aracılığıyla yapılandırmaya izin verir.
Yinelenebilir	Yes
Gerekli öznitelikler	DefaultRegistryRootAttribute
Geçersiz öznitelikler	Hiçbiri

Arayanlar İçin Notlar

Bu öznitelik yalnızca kayıt amacıyla kullanılır ve kodun çalışma zamanı davranışını etkilemez.

, ProvideOptionPageAttribute Visual Studio ayarları mekanizması aracılığıyla VSPackage'ın durumunun tamamını veya bir kısmını kalıcı hale getirme için belirli bir VSPackage desteği sağlayan veya uygulayan IProfileManager DialogPage belirli bir sınıfı kaydeder. Uygulayan sınıf tarafından kalıcı hale gelen durum bilgileri Visual Studio ayarları kategorisi olarak adlandırılır ve kayıt defterindeki tanımlayıcı girdisi Özel Ayarlar Noktası olarak adlandırılır.

Not

Yönetilen Paket Çerçevesi tabanlı özel Araçlar Seçenekleri sayfası yüklendiğinde, IDE bunu uygulayarak ProvideOptionPageAttribute kaydedilen nesnenin örneğini oluşturur. Yönetilen Paket Çerçevesi Araçları Seçenekler sayfası desteği VSPackage'ın kendisine değil kendi nesnesine uygulanmalıdır.

örneklerini ProvideOptionPageAttributeoluşturma ve uygulama hakkında daha fazla bilgi için aşağıdaki ve ProvideOptionPageAttributeörneklerine bakın.

Oluşturucular

ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, Int32)	Yeni bir ProvideOptionPageAttribute örneği oluşturur.
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String)	Yeni bir ProvideOptionPageAttribute örneği oluşturur.
ProvideOptionPageAttribute(Type, String, String, Int16, Int16, Boolean, String[])	Yeni bir ProvideOptionPageAttribute örneği oluşturur.

Özellikler

CategoryDescriptionResourceId	Sayfanın üst kategorisinin yerelleştirilmiş açıklamasını içeren kaynağın kimliği. Bu özellik yalnızca SupportsAutomation == true ve SupportsProfiles == true olduğunda kullanılır. Yerelleştirilmiş açıklama, içeri/dışarı aktarma ayarları sihirbazında görünür.
CategoryName	Araçlar Seçenekleri sayfasının kategorisinin kurallı olmayan adını alır.
CategoryPackageGuid	Bu sayfanın kayıtlı olduğu kategoriye sahip paketin kimliği. Bu ayarlanmadıysa, paketin bu özniteliğin uygulandığı paket olduğu varsayılır. Bu özellik yalnızca SupportsAutomation == true ve SupportsProfiles == true olduğunda kullanılır. Bunu Guid.ToString("B") ile bir Guid'den oluşturun.
CategoryResourceID	Araçlar Seçenekleri sayfasının kategori kaynak kimliğini alır.
DescriptionResourceId	Sayfanın yerelleştirilmiş açıklamasını içeren kaynağın kimliği. Bu özellik yalnızca SupportsAutomation == true ve SupportsProfiles == true olduğunda kullanılır. Yerelleştirilmiş açıklama, içeri/dışarı aktarma ayarları sihirbazında görünür.
IsInUnifiedSettings	Bu sayfadaki ayarların yeni kayıt oluşturularak Birleşik Ayarlar'a eklenip eklenmediğini belirten bir değer alır veya ayarlar. True ise, Birleşik Ayarlar etkinleştirildiğinde sayfa gizlenir, dolayısıyla ayarları yinelenmez.
IsServerAware	Bu sayfanın kullanıcı arabiriminin, ISettingsManager3 veya benzer işlevlere sahip bir API kullanarak bağlı bir istemci-sunucu senaryosunda sunucuyla eşitlenen ayarları gösterip göstermediğini belirten bir değer alır veya ayarlar.
Keywords	Bu seçenekler sayfası için aranabilir anahtar sözcükleri alır. Her anahtar sözcük bir değişmez değer dizesi, tek bir anahtar sözcüğü işaret eden bir kaynak adı/kimliği ("@"/"#" ön ekiyle) veya noktalı virgülle ayrılmış anahtar sözcük listesine işaret eden bir kaynak adı/kimliği ("@"/"#" ön ekiyle) olabilir.
NoShowAllView	Toplu Araçlar Seçenekleri sayfalarının gösterilip gösterilmediğini alır veya ayarlar.
PageName	Araçlar Seçenekleri sayfasının kurallı olmayan adını alır.
PageNameResourceId	Sayfanın kaynak kimliğinin adını alır. (Devralındığı yer: ProvideOptionDialogPageAttribute)
PageType	Sayfanın türünü alır. (Devralındığı yer: ProvideOptionDialogPageAttribute)
ProfileMigrationType	Profil geçiş türünü ayarlar.
ProvidesLocalizedCategoryName	Paketin kategori adı için yerelleştirilmiş kaynaklara sahip olup olmadığını belirler.
Sort	Seçenek sayfasının sıralama düzeni. Seçenek sayfaları aşağıdaki sırayla harmanlanır: `1. The General page 2. Pages with a Sort value, sorted from low to high. 3. Pages without a Sort value, sorted alphabetically.`
SupportsAutomation	Araçlar Seçenekleri sayfası uygulamasının otomasyonu destekleyip desteklemediğini alır.
SupportsProfiles	Araçlar Seçenekleri sayfası uygulamasının durumunu kalıcı hale getirmek için Visual Studio ayarları mekanizmasını kullanıp kullanmadığını alır veya ayarlar.
TypeId	öğesinin geçerli örneğini ProvideOptionPageAttributealır.
UnifiedSettingsCategoryMoniker	= false değerine sahip IsInUnifiedSettings sayfalar için, Birleşik Ayarlar hiyerarşisindeki üst kategorinin bilinen adını alır veya ayarlar. Bu, zaten var olan bir bilinen ad veya var olan bir ad ve bir ek '.' olabilir. -sınırlandırılmış kesim. İkinci kategori ise, Birleşik Ayarlar hiyerarşisinde tarafından CategoryResourceID adlı yeni bir kategori oluşturulur ve bu sayfa buna eklenir. Aksi takdirde, bu sayfa var olan kategorinin altına eklenir.
VisibilityCmdUIContexts	UIContext GUID'lerinin noktalı virgülle ayrılmış listesi. Listedeki herhangi bir UIContext etkin olduğunda seçenek sayfası görünür. Bu belirtilmezse seçenek sayfası her zaman görünür durumda olur.

Yöntemler

GetPackageRegKeyPath(Guid)	VSPackage'ın kayıt defteri yolunu (uygulamanın kayıt defteri köküne göre) alır. (Devralındığı yer: RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Araçlar Seçenekleri sayfasını kaydeder.
Unregister(RegistrationAttribute+RegistrationContext)	Araç Seçenekleri sayfa anahtarını kayıt defterinden kaldırır.

Şunlara uygulanır

Aracılığıyla paylaş