HttpClientHandler.UseDefaultCredentials Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość, która określa, czy poświadczenia domyślne są wysyłane z żądaniami przez program obsługi.
public:
property bool UseDefaultCredentials { bool get(); void set(bool value); };
public bool UseDefaultCredentials { get; set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool UseDefaultCredentials { get; set; }
member this.UseDefaultCredentials : bool with get, set
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.UseDefaultCredentials : bool with get, set
Public Property UseDefaultCredentials As Boolean
Wartość właściwości
true
jeśli są używane poświadczenia domyślne; w przeciwnym razie false
. Wartość domyślna to false
.
- Atrybuty
Uwagi
Ustaw tę właściwość na true
wartość , gdy żądania wysyłane przez HttpClientHandler obiekt powinny być uwierzytelniane przy użyciu poświadczeń aktualnie zalogowanego użytkownika, jeśli jest to wymagane przez serwer. W przypadku aplikacji klienckich jest to pożądane zachowanie w większości scenariuszy. W przypadku aplikacji warstwy środkowej, takich jak aplikacje ASP.NET, zamiast używać tej właściwości, zazwyczaj należy ustawić Credentials właściwość na poświadczenia klienta, w którym imieniu jest wykonywane żądanie.
Ta właściwość nie ma wpływu na poświadczenia serwera proxy. Gdy jest używany domyślny (systemowy) serwer proxy, ustaw poświadczenia jawnie przy użyciu DefaultProxyCredentials właściwości . Gdy serwer proxy jest ustawiany przez Proxy właściwość , ustaw poświadczenia dla serwera proxy za pośrednictwem jego Credentials właściwości.
Jeśli ta właściwość została ustawiona na true
wartość , ma ona wpływ uboczny na Credentials właściwość i Credentials zostanie ustawiona na wartość DefaultCredentials.