WebProxy.UseDefaultCredentials Proprietà

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebProxy.dll

Origine:

WebProxy.cs

Ottiene o imposta un valore Boolean che controlla se insieme alle richieste viene inviata la proprietà DefaultCredentials.

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 si utilizzano le credenziali predefinite; in caso contrario, false. Il valore predefinito è false.

Eccezioni

InvalidOperationException

È stato effettuato un tentativo di impostazione di questa proprietà quando la proprietà Credentials contiene credenziali diverse da quelle 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 della 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 o false	L'impostazione UseDefaultCredentials genera un'eccezione.

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