Vytváření předávajících (sekundárních) protokolovacích nástrojů
Předávání úhozy kláves efektivitu protokolování pomocí něhož můžete zvolit události, které chcete sledovat při vytváření projektů v systému s více procesory.Povolení předávání úhozy kláves můžete zabránit nežádoucí události z centrálního protokolování zaplaven, zpomaluje čas sestavení a zbytečného zaplnění pomocí protokolu.
Chcete-li vytvořit předávání protokolů, můžete buď provést IForwardingLogger rozhraní a poté provádět jeho metody ručně nebo použít ConfigurableForwardingLogger třídy a jeho předkonfigurovaná metody.(Ten postačí pro většinu aplikací.)
Registrace události a reagovat na ně
Předávání protokolů shromažďuje informace o události sestavení vykázání sekundární sestavení motoru, což je pracovní proces, který během vytváření hlavní vytvořené během sestavení v systému s více procesory.Pak vybere předávání protokolů událostí předá centrální protokolování zpráv na základě pokynů, které jste přidělili.
Zaregistrujte předávání úhozy kláves pro zpracování událostí, které chcete sledovat.Při registraci události musí přepsat úhozy kláves Initialize metoda.Tato metoda zahrnuje nyní volitelný parametr nodecount, který lze nastavit počet procesorů v systému.(Výchozí hodnota je 1.)
Příklady můžete sledovat události TargetStarted, ProjectStarted, a ProjectFinished.
V prostředí s více procesory jsou pravděpodobně mimo pořadí přijetí zprávy událostí.Proto musí vyhodnotit pomocí obslužné rutiny události v předávání protokolů událostí a k určení předat přesměrovač pro předávání do centrálního protokolování události programu.Chcete-li toho dosáhnout, můžete BuildEventContext třídy, který je připojen do každé zprávy k identifikaci událostí, které chcete předat dál, a průchod názvy událostí na ConfigurableForwardingLogger třídy (nebo je podtřídou).Při použití této metody žádný další zvláštní kódování není k předávání událostí.
Určit předávání protokolů
Po předávání protokolů byl zkompilován do sestavení, musí informovat MSBuild k použití během sestavení.Chcete-li to provést, použijte /FileLogger, /FileLoggerParameters, a /DistributedFileLogger přepínače společně s MSBuild.exe./FileLogger Přepínač říká MSBuild.exe protokolování je přímo připojen. /DistributedFileLogger Přepínač znamená, že je soubor protokolu v jednom uzlu.Chcete-li nastavit parametry protokolování pro předávání, použijte /FileLoggerParameters přepnout.Další informace o těchto a jiných MSBuild.exe přepínačů, viz Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádku.
Vícestupňové-Processor podporující úhozy kláves
Při vytváření projektu v systému s více procesory není sestavení zprávy z každého procesoru automaticky prokládaný unified posloupnosti.Místo toho je nutné vytvořit zprávu pomocí seskupení priority BuildEventContext třídy, která je připojena ke každé zprávě.Další informace o robustnější budovy, viz Protokolování v prostředí s více procesory.
Viz také
Koncepty
Získávání protokolů o sestavení pomocí nástroje MSBuild