Udostępnij za pośrednictwem


Tworzenia, przekazywania rejestratory

Rejestratory przekazywanie poprawy efektywności rejestrowania, umożliwiając użytkownikowi wybrać zdarzenia, które chcesz monitorować, podczas tworzenia projektów w systemie wieloprocesorowym.Przez włączenie rejestratory przesyłania dalej, można zapobiec niepożądanych zdarzeń z przeciążanie rejestratora centralnej, spowalniając czas montażu i przeładowania dziennika.

Aby utworzyć rejestratora przesyłania dalej, można albo wdrożenie IForwardingLogger interfejsu, a następnie ręcznie wprowadzić w życie jej metody lub użyć ConfigurableForwardingLogger klasy i metody jego wstępnie.(Ten ostatni będzie wystarczające dla większości aplikacji.)

Rejestr zdarzeń i odpowiadać na nich

Rejestratora przekazywanie zbiera informacje o zdarzeniach build wykazanej przez silnik pomocniczy kompilacji jest proces roboczy, który jest tworzony przez proces budowania głównego podczas kompilacji w systemie wieloprocesorowym.Następnie rejestratora przesyłanie dalej wybiera zdarzeń do przesyłania dalej do centralnej rejestratora, na podstawie instrukcji, który otrzymał on.

Należy zarejestrować rejestratory przekazywania do obsługi zdarzeń, które chcesz monitorować.Aby zarejestrować zdarzenia, należy zastąpić rejestratory Initialize metody.Niniejsza metoda zawiera teraz parametr opcjonalny, nodecount, który można podać liczbę procesorów w systemie.(Domyślnie wartością jest 1).

Przykłady zdarzeń można monitorować TargetStarted, ProjectStarted, i ProjectFinished.

W środowisku wieloprocesorowym mogą otrzymać poza kolejnością są komunikaty o zdarzeniach.W związku z tym musi ocenić zdarzeń przy użyciu programu obsługi zdarzeń w rejestratora przesyłania dalej i program, to do określenia, które zdarzenia przekazywane do readresatora do przekazywania danych do centralnej rejestratora.Aby osiągnąć ten cel, można użyć BuildEventContext klasy, w której jest dołączona do każdej wiadomości, do identyfikowania zdarzeń, które chcesz przesłać dalej, a następnie przekazać nazwy zdarzenia do ConfigurableForwardingLogger klasy (lub podklasy go).Przy użyciu tej metody nie innych szczególnych kodowanie jest wymagane do przodu zdarzenia.

Określ Rejestrator przesyłania dalej

Po rejestratora przekazywanie został skompilowany do zestawu, trzeba poinformować MSBuild używać go podczas kompilacji.Aby to zrobić, użyj /FileLogger, /FileLoggerParameters, i /DistributedFileLogger przełączniki wraz z MSBuild.exe./FileLogger Przełącznik nakazuje MSBuild.exe bezpośrednio dołączono rejestratora. /DistributedFileLogger Przełącznik oznacza jest plik dziennika w każdym węźle.Aby ustawić parametry rejestratora przesyłania dalej, użyć /FileLoggerParameters przełączyć.Aby uzyskać więcej informacji na temat tych i innych przełączników MSBuild.exe, zobacz Informacje w wierszu polecenia programu MSBuild.

Rejestratory wieloprocesorowych-Processor-Aware

Podczas tworzenia projektu w systemie wieloprocesorowym, wiadomości kompilacji z każdego procesora nie są automatycznie przeplotu w ujednoliconej sekwencji.Zamiast tego należy ustanowić wiadomości, grupowanie priorytet przy użyciu BuildEventContext klasy, która jest dołączony do każdej wiadomości.Aby uzyskać więcej informacji dotyczących tworzenia wielu procesorów, zobacz Rejestrowanie w środowisku wielu procesorów.

Zobacz też

Koncepcje

Uzyskiwanie dzienników kompilacji za pomocą narzędzia MSBuild

Budowanie rejestratory

Rejestrowanie w środowisku wielu procesorów