Integracja z Microsoft.Extensions

Te rozszerzenia łączą platformę Microsoft.Testing.Platform (MTP) z bibliotekami Microsoft.Extensions.*, z których aplikacja już korzysta, dzięki czemu składniki platformy i rozszerzeń korzystają z tej samej infrastruktury co reszta kodu. Każde rozszerzenie wymaga dodatkowego pakietu NuGet zgodnie z opisem w każdej sekcji.

Wskazówka

W przypadku korzystania z Microsoft.Testing.Platform.MSBuild (dołączonego tranzytywnie przez narzędzia uruchomieniowe MSTest, NUnit i xUnit), te rozszerzenia są automatycznie rejestrowane podczas instalowania pakietów NuGet — bez konieczności wprowadzania zmian w kodzie. Rejestracja ręczna określona w tym artykule jest wymagana tylko w przypadku wyłączenia automatycznie wygenerowanego punktu wejścia przez ustawienie<GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Mostek rejestrujący

Mostek logowania przekazuje dzienniki diagnostyczne Microsoft.Testing.Platform do ILogger, więc dzienniki platformy i rozszerzeń przechodzą przez ten sam potok Microsoft.Extensions.Logging, z którego aplikacja już korzysta. Możesz ponownie wykorzystać istniejący stos logowania — Console, Debug, Serilog, Application Insights, OpenTelemetry lub niestandardowy ILoggerProvider — bez konieczności pisania niestandardowego dostawcy loggera MTP. To rozszerzenie wymaga pakietu NuGet Microsoft.Testing.Extensions.Logging.

Note

Dostępne w MTP począwszy od wersji 2.3.0. To rozszerzenie jest eksperymentalne, a jego opcje i format danych wyjściowych mogą ulec zmianie w przyszłej wersji.

Mostek przekazuje każdy komunikat tylko wtedy, gdy włączono rejestrowanie diagnostyczne platformy. Gdy efektywny poziom logowania platformy to None (wartość domyślna, chyba że przekażesz --diagnostic), delegat konfigurujący nie jest wywoływany i nie jest tworzona żadna fabryka loggerów. Filtry według kategorii ustawione w elemecie ILoggingBuilder mogą zawęzić efektywny poziom diagnostyczny platformy, ale nie mogą go poszerzyć.

Rejestracja ręczna

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddMicrosoftExtensionsLogging(logging => logging.AddConsole());