IVsCfgProviderEventsHelper – rozhraní

Článek
08/05/2016

Implementované v prostředí, které jsou volány jako pomocné provádění projektů IVsCfgProvider2.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

[InterfaceTypeAttribute(1)]
[GuidAttribute("0D6D480C-894F-48E4-98D2-E0A7127750E4")]
public interface IVsCfgProviderEventsHelper

[InterfaceTypeAttribute(1)]
[GuidAttribute("0D6D480C-894F-48E4-98D2-E0A7127750E4")]
public interface class IVsCfgProviderEventsHelper

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("0D6D480C-894F-48E4-98D2-E0A7127750E4")>]
type IVsCfgProviderEventsHelper = interface end

<InterfaceTypeAttribute(1)>
<GuidAttribute("0D6D480C-894F-48E4-98D2-E0A7127750E4")>
Public Interface IVsCfgProviderEventsHelper

Metody

	Název	Popis
	AdviseCfgProviderEvents(IVsCfgProviderEvents, UInt32)	Nazývá se do pole přidat posluchače událostí konfigurace.
	NotifyOnCfgNameAdded(String)	Je aktivována do jímky název konfigurace přidány události pro všechny posluchače v poli.
	NotifyOnCfgNameDeleted(String)	Je aktivována do jímky konfigurační události název odstraněny pro všechny posluchače v matici.
	NotifyOnCfgNameRenamed(String, String)	Je aktivována do jímky název konfigurace přejmenovat události pro všechny posluchače v poli.
	NotifyOnPlatformNameAdded(String)	Aktivována do jímky platform název přidat události pro všechny posluchače v poli.
	NotifyOnPlatformNameDeleted(String)	Je aktivována pro všechny posluchače v poli jímky událostí platformy jméno odstranili.
	UnadviseCfgProviderEvents(UInt32)	Nazývá se odebrat posluchače z matice posluchače událostí konfigurace.

Poznámky

IVsCfgProviderumožňuje podporu platforem a úprava konfigurace projektu.Pokud projekt implementuje IVsCfgProvider2, musí implementovat jeho AdviseCfgProviderEvents a UnadviseCfgProviderEvents metod do jímky s klienty, které naslouchají události konfigurace spalovat IVsCfgProviderEvents.

Je odpovědností projektu udržovat matice poslouchání události projektu konfigurace klientů.Kromě toho musíte také mechanismus pro oznamování každého posluchače pálení, konfigurace událostí, musí mít proces, kterým smyčku matice a každá z nich požární požadované události volání.

IVsCfgProviderEventsHelperobjekt pomocníka, který poskytuje tuto funkci Správa pole posluchačů projektu a poté delegování z IVsCfgProvider2 na pomocné požární události ve správnou dobu všem uživatelům v seznamu.Při přidání, odstranění nebo přejmenování konfigurace a volání helper informuje ostatní objekty v rámci projektu a prostředí události znát zprostředkovatele konfigurace.To je důvod, proč je třeba tyto události požáru v pravý čas.Pomocí tohoto objektu pomocníka stačí předat skutečnost nového klienta naslouchá události konfigurace pro pomocné nebo klienta může být odstraněn z pole.Potom při události, stačí je předat oznámení události pomocný objekt bude trvat na odpovědnost oznamují všechny posluchače.

Pomocí objektu pomocníka můžete zapnout volání AdviseCfgProviderEvents do dvou řádků volání na AdviseCfgProviderEvents – vytvoření instance objektu nápovědy, pokud není již existují a použít pomocníka instanci sestavení pole objektů posluchače události Konfigurace upozornění.

IVsCfgProviderEventsHelperje vytvořena voláním CreateInstance metody ILocalRegistry a předá jej CLSID_VsCfgProviderEventsHelper.Jednou instancí IVsCfgProviderEventsHelper je spuštěn, AdviseCfgProviderEvents a UnadviseCfgProviderEvents bude přidání a odebrání posluchače událostí do pole.

Podobně provádění UnadviseCfgProviderEvents prochází pomocné metody UnadviseCfgProviderEvents posluchače z pole přijmout.

Pak, provádění oznámení jímky událostí by vyvolání události konfigurace, bude záležitost jednoho řádku volání z IVsCfgProviderEvents na příslušnou metodu upozornit na IVsCfgProviderEventsHelper kdo oznámí všechny posluchače v matici.Tímto způsobem můžete předat jeden oznámení, že název konfigurace byl přidán, například z AddCfgsOfCfgName, až OnCfgNameAdded, na NotifyOnCfgNameAdded pak kdo bude odpovědný za všechny posluchače události upozornění.

Můžete to samozřejmě implementovat IVsCfgProvider2 funkce sami přímo a spravovat toto pole propadů, ale pomocníka, který umožňuje jednodušší pomocí jednoho řádku volání implementovat poradenství, Unadvise a Oznamovat události.

Poznámky pro implementátory:

Prostředí poskytovat upozornění na události související s konfigurací spalujících implementován.

Poznámky pro volající:

Projekty, které používají tento objekt jako pomocníka pro provádění nazývá IVsCfgProvider2, udržuje matice klientů, které naslouchají události a dojde k oznámení události konfigurace pro klienty.

Viz také

Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím