Integrazione con Microsoft.Extensions

Queste estensioni collegano Microsoft.Testing.Platform (MTP) alle librerie Microsoft.Extensions.* già utilizzate dall'applicazione, così i componenti della piattaforma e delle estensioni passano tramite la stessa infrastruttura del resto del codice. Ogni estensione richiede un pacchetto NuGet aggiuntivo, come descritto in ogni sezione.

Tip

Quando si usa Microsoft.Testing.Platform.MSBuild (incluso transitivamente da MSTest, NUnit e runner xUnit), queste estensioni vengono registrate automaticamente quando si installano i pacchetti NuGet, senza necessità di modifiche al codice. La registrazione manuale specificata in questo articolo è necessaria solo se il punto di ingresso generato automaticamente è stato disabilitato impostando <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Bridge di registrazione

Il bridge di registrazione inoltra i log diagnostici di Microsoft.Testing.Platform a ILogger, così i log della piattaforma e delle estensioni passano attraverso la stessa pipeline Microsoft.Extensions.Logging già utilizzata dall'applicazione. È possibile riutilizzare uno stack di logging esistente — Console, Debug, Serilog, Application Insights, OpenTelemetry o un elemento personalizzato ILoggerProvider — senza scrivere un provider di logging MTP personalizzato. Questa estensione richiede il pacchetto NuGet Microsoft.Testing.Extensions.Logging.

Note

Disponibile in MTP a partire dalla versione 2.3.0. Questa estensione è sperimentale e le opzioni e il formato di output potrebbero cambiare in una versione futura.

Il bridge inoltra ogni messaggio solo quando la registrazione diagnostica della piattaforma è abilitata. Quando il livello di log effettivo della piattaforma è None (impostazione predefinita, a meno che non si passi --diagnostic), il delegato di configurazione non viene richiamato e non viene creata alcuna factory del logger. I filtri per categoria impostati in ILoggingBuilder possono limitare il livello di diagnostica effettivo della piattaforma, ma non possono estenderlo.

Registrazione manuale

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddMicrosoftExtensionsLogging(logging => logging.AddConsole());
  • Last updated on