WebProxy.UseDefaultCredentials Proprietà

Definizione

Spazio dei nomi:

System.Net

Assembly:

netstandard.dll, System.Net.WebProxy.dll

Origine:

WebProxy.cs

Ottiene o imposta un Boolean valore che controlla se l'oggetto DefaultCredentials viene inviato con richieste.

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

Valore della proprietà

Boolean

true se vengono usate le credenziali predefinite; in caso contrario, false. Il valore predefinito è false.

Eccezioni

InvalidOperationException

Si è tentato di impostare questa proprietà quando la Credentials proprietà contiene credenziali diverse dalle credenziali predefinite.

Commenti

Impostare questa proprietà su true quando le richieste effettuate da questo WebProxy oggetto devono, se richiesto dal server, essere autenticate usando le credenziali dell'utente attualmente connesso. Per le applicazioni client, questo è il comportamento desiderato nella maggior parte degli scenari. Per le applicazioni di livello intermedio, ad esempio ASP.NET applicazioni, anziché usare questa proprietà, in genere si imposta la Credentials proprietà sulle credenziali del client per conto del quale viene effettuata la richiesta.

Nella tabella seguente viene illustrato l'effetto dell'impostazione del UseDefaultCredentials valore, in base al valore della Credentials proprietà .

Valore della proprietà Credentials	Valore della proprietà UseDefaultCredentials	Effetto
DefaultCredentials	true	Nessun effetto.
DefaultCredentials	false	Credentials è impostato su null.
null	true	Credentials è impostato su DefaultCredentials.
Qualsiasi valore diverso da DefaultCredentials o null	true oppure false	L'impostazione UseDefaultCredentials genera un'eccezione.

Se UseDefaultCredentials è false, è possibile modificare la Credentials proprietà in qualsiasi credenziale. Se UseDefaultCredentials è true, la modifica della Credentials proprietà da DefaultCredentials (il valore impostato quando la UseDefaultCredentials proprietà è impostata su true) genererà un'eccezione.