HttpClientFactoryOptions.HandlerLifetime Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Dauer ab, die eine HttpMessageHandler Instanz wiederverwendet werden kann, oder legt sie fest. Für jeden benannten Client kann ein eigener Wert für die Lebensdauer des Handlers konfiguriert werden. Der Standardwert dieser Eigenschaft beträgt zwei Minuten. Legen Sie die Lebensdauer fest, um den Ablauf des Handlers zu InfiniteTimeSpan deaktivieren.
public:
property TimeSpan HandlerLifetime { TimeSpan get(); void set(TimeSpan value); };
public TimeSpan HandlerLifetime { get; set; }
member this.HandlerLifetime : TimeSpan with get, set
Public Property HandlerLifetime As TimeSpan
Eigenschaftswert
Hinweise
Die Standardimplementierung von IHttpClientFactory Willens poolen die Instanzen, die von der Factory erstellt wurden, um den HttpMessageHandler Ressourcenverbrauch zu verringern. Diese Einstellung konfiguriert, wie lange ein Handler zusammengefasst werden kann, bevor er für die Entfernung aus dem Pool und zur Entsorgung geplant ist.
Die Poolerstellung von Handlern ist wünschenswert, da jeder Handler normalerweise seine eigenen zugrunde liegenden HTTP-Verbindungen verwaltet; Das Erstellen von mehr Handlern als erforderlich kann zu Verbindungsverzögerungen führen. Einige Handler halten Verbindungen auch unbegrenzt offen, wodurch verhindert werden kann, dass der Handler auf DNS-Änderungen reagiert. Der Wert sollte HandlerLifetime mit einem Verständnis der Anforderung der Anwendung ausgewählt werden, auf Änderungen in der Netzwerkumgebung zu reagieren.
Der Ablauf eines Handlers wird den Handler nicht sofort verwerfen. Ein abgelaufener Handler wird in einem separaten Pool platziert, der in Intervallen verarbeitet wird, um Handler nur zu verwerfen, wenn sie nicht erreichbar sind. Durch die Verwendung von langlebigen HttpClient Instanzen wird verhindert, dass die zugrunde liegende HttpMessageHandler Klammer verworfen wird, bis alle Verweise garbage-collection sind.