HttpClientBuilderExtensions.AddLogger Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Přidá delegáta, který se použije k vytvoření dalšího protokolovacího nástroje pro pojmenovaný HttpClient. Vlastní protokolovací nástroj by byl vyvolán z vyhrazené obslužné rutiny delegování protokolování u každého požadavku odpovídajícího s názvem HttpClient. |
AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Přidá delegáta, který se použije k vytvoření dalšího protokolovacího nástroje pro pojmenovaný HttpClient. Vlastní protokolovací nástroj by byl vyvolán z vyhrazené obslužné rutiny delegování protokolování u každého požadavku odpovídajícího s názvem HttpClient. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Přidá delegáta, který se použije k vytvoření dalšího protokolovacího nástroje pro pojmenovaný HttpClient. Vlastní protokolovací nástroj by byl vyvolán z vyhrazené obslužné rutiny delegování protokolování u každého požadavku odpovídajícího s názvem HttpClient.
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<IServiceProvider,Microsoft.Extensions.Http.Logging.IHttpClientLogger> httpClientLoggerFactory, bool wrapHandlersPipeline = false);
static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<IServiceProvider, Microsoft.Extensions.Http.Logging.IHttpClientLogger> * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder
<Extension()>
Public Function AddLogger (builder As IHttpClientBuilder, httpClientLoggerFactory As Func(Of IServiceProvider, IHttpClientLogger), Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilder
Parametry
- builder
- IHttpClientBuilder
Hodnota IHttpClientBuilder
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Delegát, který se používá k vytvoření vlastního protokolovacího nástroje. Protokolovací nástroj by měl implementovat IHttpClientLogger nebo IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
true
Přidat obslužnou rutinu protokolování s vlastním protokolovacím nástrojem na začátek dalšího řetězu obslužných rutin; false
a přidejte ho na konec řetězce.
Návraty
Slouží IHttpClientBuilder ke konfiguraci klienta.
Poznámky
Pokud wrapHandlersPipeline
je hodnota true a LogRequestStart(HttpRequestMessage)LogRequestStartAsync(HttpRequestMessage, CancellationToken) provede se před všemi ostatními dalšími obslužné rutiny v řetězci.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) a LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se spustí po všech dalších obslužných rutinách, které v podstatě zabalí celý kanál.
Pokud wrapHandlersPipeline
je hodnota false a LogRequestStart(HttpRequestMessage)LogRequestStartAsync(HttpRequestMessage, CancellationToken) spustí se po všech dalších obslužných rutinách v řetězci přímo před primární obslužnou rutinou.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) a LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se spustí před všemi ostatními dalšími obslužné rutiny hned po primární obslužné rutině.
Argument IServiceProvider zadaný pro httpClientLoggerFactory
bude odkazem na poskytovatele služeb s vymezeným oborem, který sdílí životnost vytvářeného řetězce obslužných rutin.
Pokud AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) je volána vícekrát, přidá se více protokolovacích nástrojů. Pokud RemoveAllLoggers(IHttpClientBuilder) nebyl volána před voláním AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), přidá se kromě výchozích protokolovací nástroj nový protokolovací nástroj.
Platí pro
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Přidá delegáta, který se použije k vytvoření dalšího protokolovacího nástroje pro pojmenovaný HttpClient. Vlastní protokolovací nástroj by byl vyvolán z vyhrazené obslužné rutiny delegování protokolování u každého požadavku odpovídajícího s názvem HttpClient.
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger<TLogger> (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, bool wrapHandlersPipeline = false) where TLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger;
static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Logger :> Microsoft.Extensions.Http.Logging.IHttpClientLogger)
<Extension()>
Public Function AddLogger(Of TLogger As IHttpClientLogger) (builder As IHttpClientBuilder, Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilder
Parametry typu
- TLogger
Typ služby vlastního protokolovacího nástroje, který byl zaregistrován v distanci. Protokolovací nástroj by měl implementovat IHttpClientLogger nebo IHttpClientAsyncLogger.
Parametry
- builder
- IHttpClientBuilder
Hodnota IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
true
Přidat obslužnou rutinu protokolování s vlastním protokolovacím nástrojem na začátek dalšího řetězu obslužných rutin; false
a přidejte ho na konec řetězce.
Návraty
Slouží IHttpClientBuilder ke konfiguraci klienta.
Poznámky
Pokud wrapHandlersPipeline
je hodnota true a LogRequestStart(HttpRequestMessage)LogRequestStartAsync(HttpRequestMessage, CancellationToken) provede se před všemi ostatními dalšími obslužné rutiny v řetězci.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) a LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se spustí po všech dalších obslužných rutinách, které v podstatě zabalí celý kanál.
Pokud wrapHandlersPipeline
je hodnota false a LogRequestStart(HttpRequestMessage)LogRequestStartAsync(HttpRequestMessage, CancellationToken) spustí se po všech dalších obslužných rutinách v řetězci přímo před primární obslužnou rutinou.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) a LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se spustí před všemi ostatními dalšími obslužné rutiny hned po primární obslužné rutině.
Přeloží TLogger
se od poskytovatele služeb s vymezeným oborem, který sdílí životnost vytvářeného řetězce obslužných rutin.
Pokud AddLogger<TLogger>(IHttpClientBuilder, Boolean) je volána vícekrát, přidá se více protokolovacích nástrojů. Pokud RemoveAllLoggers(IHttpClientBuilder) nebyl volána před voláním AddLogger<TLogger>(IHttpClientBuilder, Boolean), přidá se kromě výchozích protokolovací nástroj nový protokolovací nástroj.