HttpWebRequest.PreAuthenticate Свойство

Определение

Возвращает или задает значение, указывающее, следует ли отправлять заголовок авторизации вместе с запросом.Gets or sets a value that indicates whether to send an Authorization header with the request.

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.true to send an HTTP Authorization header with requests after authentication has taken place; otherwise, false. Значение по умолчанию — false.The default is false.

Комментарии

После Uri успешной проверки подлинности клиентского запроса к определенной PreAuthenticate учетной записи, если задано значение true и предоставлены данные, заголовок авторизации отправляется вместе с каждым запросом к любому Uri , совпадающему с Uri последней косой чертой.After a client request to a specific Uri is successfully authenticated, if PreAuthenticate is true and credentials are supplied, the Authorization header is sent with each request to any Uri that matches the specific Uri up to the last forward slash. Таким образом, если клиент успешно прошел проверку подлинности в определенном запросе Uri , который содержит следующее:So if the client request successfully authenticated to a specific Uri that contains the following:

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

Затем заголовок авторизации для предварительной проверки подлинности отправляется с каждым запросом в любой из следующих Uri экземпляров:Then the Authorization header for preauthentication is sent with each request to any of the following Uri instances:

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

Однако заголовок авторизации не отправляется с запросами ни к одному из следующих Uri экземпляров:However, the Authorization header is not sent with requests to any of the following Uri instances:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

Если запрос клиента к определенному Uri не прошел проверку подлинности, запрос использует стандартные процедуры проверки подлинности.If the client request to a specific Uri is not successfully authenticated, the request uses standard authentication procedures.

За исключением первого запроса, PreAuthenticate свойство указывает, следует ли отправлять сведения о проверке подлинности с последующими запросами к, который соответствует заданному до Uri Uri последней косой черты, не дожидаясь обращения к серверу.With the exception of the first request, the PreAuthenticate property indicates whether to send authentication information with subsequent requests to a Uri that matches the specific Uri up to the last forward slash without waiting to be challenged by the server.

В следующем диалоговом окне между клиентом и сервером показан результат этого свойства.The following dialog between client and server illustrates the effect of this property. В диалоговом окне предполагается, что используется обычная проверка подлинности.The dialog assumes that basic authentication is in use.

PreAuthenticate имеет false следующее:PreAuthenticate is false:

Клиент: GET СомеурлClient: GET someUrl

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

Клиент: получение с заголовками авторизацииClient: GET with Authorization headers

Сервер: 200 ОКServer: 200 OK

Клиент: GET СомеурлClient: GET someUrl

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

Клиент: получение с заголовками авторизацииClient: GET with Authorization headers

Сервер: 200 ОКServer: 200 OK

PreAuthenticate имеет true следующее:PreAuthenticate is true:

Клиент: GET СомеурлClient: GET someUrl

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

Клиент: получение с заголовками авторизацииClient: GET with Authorization headers

Сервер: 200 ОКServer: 200 OK

Клиент: получение Сомеурл с заголовками авторизацииClient: GET someUrl with Authorization headers

Если схема проверки подлинности не поддерживает предварительную проверку подлинности, значение этого свойства игнорируется.If the authentication scheme does not support preauthentication, the value of this property is ignored.

Применяется к