WebProxy.UseDefaultCredentials Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebProxy.dll

Source:

WebProxy.cs

Obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.

public:
 property bool UseDefaultCredentials { bool get(); void set(bool value); };

public bool UseDefaultCredentials { get; set; }

member this.UseDefaultCredentials : bool with get, set

Public Property UseDefaultCredentials As Boolean

Valor de propiedad

Boolean

Es true si se utilizan las credenciales predeterminadas; en caso contrario, es false. El valor predeterminado es false.

Excepciones

InvalidOperationException

Se intentó establecer esta propiedad cuando la propiedad Credentials contenía credenciales distintas de las predeterminadas.

Comentarios

Establezca esta propiedad true en cuando las solicitudes realizadas por este WebProxy objeto deben autenticarse, si lo solicita el servidor, mediante las credenciales del usuario que ha iniciado sesión actualmente. En el caso de las aplicaciones cliente, este es el comportamiento deseado en la mayoría de los escenarios. En el caso de las aplicaciones de nivel intermedio, como ASP.NET aplicaciones, en lugar de usar esta propiedad, normalmente establecería la Credentials propiedad en las credenciales del cliente en cuyo nombre se realiza la solicitud.

En la tabla siguiente se muestra el efecto de establecer el UseDefaultCredentials valor, en función del valor de la Credentials propiedad .

Valor de Credentials	Valor de UseDefaultCredentials	Efecto
DefaultCredentials	true	Ningún efecto.
DefaultCredentials	false	El valor de Credentials está establecido en null.
null	true	El valor de Credentials está establecido en DefaultCredentials.
Cualquier valor distinto de DefaultCredentials o null	true o false	La configuración UseDefaultCredentials produce una excepción.

Si UseDefaultCredentials es false, puede cambiar la Credentials propiedad a cualquier credencial. Si UseDefaultCredentials es true, al cambiar la Credentials propiedad de DefaultCredentials (el valor establecido cuando la UseDefaultCredentials propiedad se establece trueen ) se producirá una excepción.