HttpWebRequest.PreAuthenticate 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ść wskazującą, czy wysłać nagłówek autoryzacji z żądaniem.
public:
virtual property bool PreAuthenticate { bool get(); void set(bool value); };
public override bool PreAuthenticate { get; set; }
member this.PreAuthenticate : bool with get, set
Public Overrides Property PreAuthenticate As Boolean
Wartość właściwości
true
do wysyłania nagłówka autoryzacji HTTP z żądaniami po uwierzytelnieniu; w przeciwnym razie , false
. Wartość domyślna to false
.
Uwagi
Po pomyślnym uwierzytelnieniu żądania klienta do określonego Uri elementu, jeśli PreAuthenticate podano true
poświadczenia i podano poświadczenia, nagłówek autoryzacji jest wysyłany z każdym żądaniem do dowolnego Uri , który pasuje do określonego Uri ukośnika do ostatniego ukośnika. Jeśli więc klient zażądał pomyślnego uwierzytelnienia do określonego elementu Uri , który zawiera następujące elementy:
http://www.contoso.com/firstpath/
Następnie nagłówek autoryzacji dla wstępnego uwierzytelniania jest wysyłany z każdym żądaniem do dowolnego z następujących Uri wystąpień:
http://www.contoso.com/firstpath/
http://www.contoso.com/firstpath/default
http://www.contoso.com/firstpath/default.html
http://www.contoso.com/firstpath/sample.html
Jednak nagłówek autoryzacji nie jest wysyłany z żądaniami do żadnego z następujących Uri wystąpień:
http://www.contoso.com/
http://www.contoso.com/firstpath
http://www.contoso.com/secondpath/
http://www.contoso.com/firstpath/thirdpath/
Jeśli żądanie klienta do określonego Uri elementu nie zostało pomyślnie uwierzytelnione, żądanie używa standardowych procedur uwierzytelniania.
Z wyjątkiem pierwszego żądania właściwość wskazuje, PreAuthenticate czy wysyłać informacje uwierzytelniania z kolejnymi żądaniami do elementu, które pasują do Uri określonego Uri ukośnika do ostatniego ukośnika bez oczekiwania na żądanie przez serwer.
Poniższe okno dialogowe między klientem a serwerem ilustruje efekt tej właściwości. W oknie dialogowym założono, że jest używane uwierzytelnianie podstawowe.
PreAuthenticate is false
:
Klient: GET someUrl
Serwer: 401 WWW-Authenticate Basic
Klient: GET z nagłówkami autoryzacji
Serwer: 200 OK
Klient: GET someUrl
Serwer: 401 WWW-Authenticate Basic
Klient: GET z nagłówkami autoryzacji
Serwer: 200 OK
PreAuthenticate is true
:
Klient: GET someUrl
Serwer: 401 WWW-Authenticate Basic
Klient: GET z nagłówkami autoryzacji
Serwer: 200 OK
Klient: GET someUrl z nagłówkami autoryzacji
Jeśli schemat uwierzytelniania nie obsługuje wstępnego uwierzytelniania, wartość tej właściwości jest ignorowana.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla