WebProxy.UseDefaultCredentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение 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
Значение свойства
Значение равно true
, если используются учетные данные по умолчанию, в противном случае — false
. Значение по умолчанию — false
.
Исключения
Произведена попытка задать это свойства, в то время как свойство 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 создает исключение. |
Если UseDefaultCredentials имеет значение false
, можно изменить Credentials свойство на любые учетные данные. Если UseDefaultCredentials имеет значение true
, изменение Credentials свойства с DefaultCredentials (значение, заданное UseDefaultCredentials , когда свойство имеет значение true
), вызовет исключение.