WebProxy.UseDefaultCredentials Свойство

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.WebProxy.dll

Исходный код:

WebProxy.cs

Возвращает или задает Boolean значение, которое определяет, отправляются ли 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

Значение свойства

Boolean

true Значение , если используются учетные данные по умолчанию; falseв противном случае . Значение по умолчанию — false.

Исключения

InvalidOperationException

Вы попытались задать это свойство, если Credentials свойство содержит учетные данные, отличные от учетных данных по умолчанию.

Комментарии

Задайте для этого свойства true значение, когда запросы, сделанные этим WebProxy объектом, должны быть проверены на проверку подлинности с помощью учетных данных текущего пользователя, вошедшего в систему. Для клиентских приложений это необходимое поведение в большинстве сценариев. Для приложений среднего уровня, таких как ASP.NET приложения, вместо использования этого свойства обычно необходимо задать Credentials для свойства учетные данные клиента, от имени которого выполняется запрос.

В следующей таблице показан эффект задания UseDefaultCredentials значения на основе значения Credentials свойства.

Значение Credentials	Значение UseDefaultCredentials	Эффект
DefaultCredentials	true	Нет эффекта.
DefaultCredentials	false	Credentials задан как null.
null	true	Credentials задан как DefaultCredentials.
Любое значение, отличное от DefaultCredentials или null	true или false	Параметр UseDefaultCredentials вызывает исключение.

В противном случае UseDefaultCredentialsfalseможно изменить Credentials свойство на любые учетные данные. Если UseDefaultCredentials это trueтак, изменение Credentials свойства с DefaultCredentials (значение, заданное, если UseDefaultCredentials свойство задано trueна ) вызовет исключение.