HttpWebRequest.PreAuthenticate Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

Obtiene o establece un valor que indica si se envía un encabezado de autorización con la solicitud.

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 de propiedad

Boolean

true para enviar un encabezado de autorización HTTP con solicitudes después de que se haya realizado la autenticación; de lo contrario, false. El valor predeterminado es false.

Comentarios

Después de autenticar correctamente una solicitud de cliente a un específico Uri , si PreAuthenticate es y true se proporcionan credenciales, el encabezado Authorization se envía con cada solicitud a cualquier Uri que coincida con el específico Uri hasta la última barra diagonal. Por lo tanto, si la solicitud de cliente se ha autenticado correctamente en un elemento específico Uri que contiene lo siguiente:

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

A continuación, el encabezado Authorization para la autenticación previa se envía con cada solicitud a cualquiera de las instancias siguientes 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

Sin embargo, el encabezado Authorization no se envía con solicitudes a ninguna de las instancias siguientes Uri :

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Si la solicitud de cliente a un elemento específico Uri no se autentica correctamente, la solicitud usa procedimientos de autenticación estándar.

Con la excepción de la primera solicitud, la PreAuthenticate propiedad indica si se debe enviar información de autenticación con solicitudes posteriores a un Uri objeto que coincida con el específico Uri hasta la última barra diagonal sin esperar a que el servidor pueda impugnar.

El siguiente cuadro de diálogo entre el cliente y el servidor muestra el efecto de esta propiedad. En el cuadro de diálogo se supone que la autenticación básica está en uso.

PreAuthenticate es false:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

PreAuthenticate es true:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

Cliente: GET someUrl con encabezados de autorización

Si el esquema de autenticación no admite la autenticación previa, se omite el valor de esta propiedad.