HttpWebRequest.PreAuthenticate Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Исходный код:

HttpWebRequest.cs

Возвращает или задает значение, указывающее, следует ли отправлять заголовок авторизации вместе с запросом.

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

Значение свойства

Boolean

true для отправки заголовка авторизации HTTP с запросами после проверки подлинности; в противном случае — false. Значение по умолчанию — false.

Комментарии

После успешной проверки подлинности запроса клиента к определенному Uri объекту, если PreAuthenticate задано значение is true и предоставлены учетные данные, заголовок авторизации отправляется с каждым запросом на любой Uri запрос, соответствующий определенной Uri косой черте до последней косой черты. Таким образом, если клиентский запрос успешно прошел проверку подлинности в конкретном Uri объекте, который содержит следующее:

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

Затем заголовок Authorization для предварительной проверки подлинности отправляется с каждым запросом в любой из следующих Uri экземпляров:

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

Однако заголовок Authorization не отправляется с запросами ни в один из следующих Uri экземпляров:

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

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

Если клиентский запрос к определенному объекту Uri не прошел проверку подлинности, в запросе используются стандартные процедуры проверки подлинности.

За исключением первого запроса, свойство указывает, PreAuthenticate следует ли отправлять сведения о проверке подлинности с последующими запросами в объект , соответствующий Uri определенной Uri косой черте до последней косой черты, не дожидаясь запроса сервера.

В следующем диалоговом окне между клиентом и сервером показан эффект этого свойства. В диалоговом окне предполагается, что используется обычная проверка подлинности.

PreAuthenticate имеет значение false:

Клиент: GET someUrl

Сервер: 401 WWW-Authenticate Basic

Клиент: GET с заголовками авторизации

Сервер: 200 OK

Клиент: GET someUrl

Сервер: 401 WWW-Authenticate Basic

Клиент: GET с заголовками авторизации

Сервер: 200 OK

PreAuthenticate имеет значение true:

Клиент: GET someUrl

Сервер: 401 WWW-Authenticate Basic

Клиент: GET с заголовками авторизации

Сервер: 200 OK

Клиент: GET someUrl с заголовками авторизации

Если схема проверки подлинности не поддерживает предварительную проверку подлинности, значение этого свойства игнорируется.