WebProxy.UseDefaultCredentials Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebProxy.dll

Źródło:

WebProxy.cs

Pobiera lub ustawia wartość, która określa Boolean , czy DefaultCredentials są wysyłane z żądaniami.

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

Wartość właściwości

Boolean

true jeśli są używane poświadczenia domyślne; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Podjęto próbę ustawienia tej właściwości, gdy Credentials właściwość zawiera poświadczenia inne niż poświadczenia domyślne.

Uwagi

Ustaw tę właściwość na true wartość, gdy żądania wysyłane przez ten WebProxy obiekt powinny, jeśli zażądano tego serwera, będą uwierzytelniane przy użyciu poświadczeń aktualnie zalogowanego użytkownika. W przypadku aplikacji klienckich jest to pożądane zachowanie w większości scenariuszy. W przypadku aplikacji warstwy środkowej, takich jak aplikacje ASP.NET, zamiast używać tej właściwości, zazwyczaj należy ustawić Credentials właściwość na poświadczenia klienta w jego imieniu.

W poniższej tabeli przedstawiono wpływ ustawiania UseDefaultCredentials wartości na podstawie wartości Credentials właściwości.

Credentials Wartość	UseDefaultCredentials Wartość	Efekt
DefaultCredentials	true	Brak wpływu.
DefaultCredentials	false	Credentials jest ustawiona na nullwartość .
null	true	Credentials jest ustawiona na DefaultCredentialswartość .
Dowolna wartość inna niż DefaultCredentials lub null	true lub false	Ustawienie UseDefaultCredentials zgłasza wyjątek.

Jeśli UseDefaultCredentials jest to false, możesz zmienić Credentials właściwość na dowolne poświadczenia. Jeśli UseDefaultCredentials jest to true, zmiana Credentials właściwości z DefaultCredentials (wartość ustawiona, gdy UseDefaultCredentials właściwość jest ustawiona na true) zgłosi wyjątek.