ProvideProfileAttribute Třída

Definice

public ref class ProvideProfileAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class ProvideProfileAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideProfileAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideProfileAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideProfileAttribute
Inherits RegistrationAttribute

Dědičnost

Attribute

RegistrationAttribute

ProvideProfileAttribute

Atributy

AttributeUsageAttribute

Příklady

V následujícím příkladu jsou na implementaci ProvideProfileAttribute VSPackage použity dvě instance nástroje , které definují dvě třídy tak, aby poskytovaly podporu nastavení sady Visual Studio pro VSPackage implementované třídou MyPackage.

1. Vzhledem k tomu, že implementace stránky s názvem "DesignerOptionsPage" je odvozena z DialogPage, může podporovat nastavení sady Visual Studio a stránky možností nástroje a jsou registrovány jako poskytující obojí:

   • Implementace stránky Možnosti nástrojů , která je registrována prostřednictvím instance ProvideOptionPageAttribute. Další informace o podpoře stránek s možnostmi nástrojů najdete v tématu ProvideOptionPageAttribute.

   • Implementace, která podporuje zachování stavu stránek možností nástroje , který je označen posledním argumentem konstruktoru ProvideProfileAttribute .

2. Třída s názvem PersistedDesignerState je registrována jako poskytující podporu pouze nastavení sady Visual Studio a ukládá a načítá zbývající informace o stavu balíčku VSPackage s názvem MyPackage implementací IProfileManager.

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  
}  

Poznámky

Poznámky pro volající

ProvideProfileAttribute Použijte atribut na třídy implementují VSPackage, pokud existuje třída, která implementuje funkci nastavení sady Visual Studio pro VSPackage, což umožňuje uložit a načíst informace o stavu VSPackage.

Kontext atributu

Poznámky pro implementátory

Tento atribut se používá pouze pro účely registrace a nemá vliv na chování za běhu.

ProvideProfileAttribute zaregistruje třídu implementující IProfileManager nebo DialogPage jako poskytující podporu pro zachování části nebo celého stavu VSPackage prostřednictvím mechanismu nastavení sady Visual Studio. Informace o stavu, které implementuje třída, se označuje jako kategorie nastavení sady Visual Studio a její definující položka v registru se označuje jako vlastní bod nastavení.

Když uživatel vybere v nabídce Nástroje příkaz Nastavení importu/exportu a uloží nastavení sady Visual Studio, vytvoří se instance tříd zaregistrovaných v ProvideProfileAttribute integrovaném vývojovém prostředí (IDE) a použijí se k uložení nastavení.

Z tohoto důvodu:

• Podpora nastavení sady Visual Studio by měla být implementována u vlastního objektu, nikoli v samotném balíčku VSPackage.

• Třída, která implementuje nastavení sady Visual Studio, může podporovat pouze jednu kategorii nastavení sady Visual Studio, jak je definována v bodu vlastního nastavení.

Jeden balíček VSPackage však může podporovat několik kategorií nastavení sady Visual Studio definovaných několika body vlastního nastavení za předpokladu, že:

• Každá kategorie nastavení sady Visual Studio je implementována v samostatné třídě.

• Každá třída, která implementuje nastavení sady Visual Studio, je zaregistrovaná jako podpora balíčku VSPackage vlastní instancí nástroje ProvideProfileAttribute.

  Poznámka

  To se liší od implementací založených na modelu COM, kde třída implementující nastavení sady Visual Studio může podporovat více bodů vlastního nastavení.

Instance :ProvideProfileAttribute

• Jedinečně identifikuje kategorii nastavení vlastního bodu nastavení sady Visual Studio pomocí identifikátoru GUID získaného z Type třídy implementované nastavení sady Visual Studio.

• Nastaví název kategorie nastavení sady Visual Studio, a to jak její kanonický, nelokalizovaný název použitý v položkách registru, tak i lokalizované prostředky názvu.

• Označuje, jestli nastavení sady Visual Studio podporující implementaci ProvideProfileAttribute třídy podporuje stránku Možnosti nástrojů (další informace o stránce Možnosti podpory nástrojů najdete v tématu Stránky možností).

Další informace o vytváření a použití instancí ProvideProfileAttributenástroje najdete v následujícím příkladu a ProvideProfileAttribute.

Konstruktory

Vlastnosti

Metody

Platí pro