HttpWebRequest.PreAuthenticate Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

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. De manera predeterminada, es false.

Comentarios

Después de que se autentique correctamente una solicitud de cliente a un específico Uri , si PreAuthenticate es true y se proporcionan credenciales, el encabezado Authorization se envía con cada solicitud a cualquiera 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 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 siguientes Uri instancias:

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 siguientes Uri instancias:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

Si la solicitud de cliente a un 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 envía información de autenticación con solicitudes posteriores a un Uri objeto que coincide con la barra diagonal específica Uri hasta la última barra diagonal sin esperar a que el servidor pueda desafiarla.

En el cuadro de diálogo siguiente entre el cliente y el servidor se 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.