HttpWebRequest.PreAuthenticate Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

Źródło:

HttpWebRequest.cs

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

Boolean

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.