HttpWebRequest.PreAuthenticate Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

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, nagłówek autoryzacji jest wysyłany wraz z każdym żądaniem Uri zgodnym z określonym Uri ukośnikiem do ostatniego ukośnika. Jeśli więc żądanie klienta pomyślnie uwierzytelnione do określonego Uri elementu, który zawiera następujące elementy:

http://www.contoso.com/firstpath/

Następnie nagłówek Autoryzacja na potrzeby 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 o uwierzytelnianiu z kolejnymi żądaniami do elementu Uri , który pasuje do ostatniego Uri ukośnika do ostatniego ukośnika bez oczekiwania na żądanie przez serwer.

Następujące 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.