HttpWebRequest.PreAuthenticate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Overrides Property PreAuthenticate As BooleanValor da propriedade
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.
