HttpWebRequest.PreAuthenticate Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define um valor que indica se um cabeçalho de autorização deve ser enviado com a solicitação.

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

Valor da propriedade

Boolean

true enviar um cabeçalho de Autorização HTTP com solicitações após a autenticação ter ocorrido; caso contrário, false. O padrão é false.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Depois que uma solicitação de cliente para um Uri específico for autenticada com êxito, se PreAuthenticate for true e as credenciais forem fornecidas, o cabeçalho de Autorização será enviado com cada solicitação para qualquer Uri que corresponda à Uri específica até a última barra de encaminhamento. Portanto, se a solicitação do cliente foi autenticada com êxito em um Uri específico que contém o seguinte:

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

Em seguida, o cabeçalho de autorização para pré-autenticação é enviado com cada solicitação para qualquer uma das seguintes instâncias de 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

No entanto, o cabeçalho de Autorização não é enviado com solicitações para nenhuma das seguintes instâncias de Uri:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Se a solicitação do cliente para um Uri específico não for autenticada com êxito, a solicitação usará procedimentos de autenticação padrão.

Com exceção da primeira solicitação, a propriedade PreAuthenticate indica se é necessário enviar informações de autenticação com solicitações subsequentes para um Uri que corresponda à Uri específica até a última barra de encaminhamento sem esperar para ser desafiada pelo servidor.

A caixa de diálogo a seguir entre o cliente e o servidor ilustra o efeito dessa propriedade. A caixa de diálogo pressupõe que a autenticação básica esteja em uso.

PreAuthenticate é false:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

PreAuthenticate é true:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

Cliente: GET someUrl com cabeçalhos de autorização

Se o esquema de autenticação não der suporte à pré-autenticação, o valor dessa propriedade será ignorado.