WebProxy.UseDefaultCredentials Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.WebProxy.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: WebProxy.cs

Źródło:: WebProxy.cs

Źródło:: WebProxy.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia Boolean wartość, która kontroluje, czy DefaultCredentials obiekt jest wysyłany 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 zostać uwierzytelnione 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 którym imieniu jest wykonywane żądanie.

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 parametr jest ustawiony na `null`wartość .
`null`	`true`	Credentials parametr jest ustawiony na DefaultCredentialswartość .
Dowolna wartość inna niż DefaultCredentials lub `null`	`true` lub `false`	Ustawienie UseDefaultCredentials zgłasza wyjątek.

Jeśli UseDefaultCredentials parametr ma falsewartość , możesz zmienić Credentials właściwość na dowolne poświadczenia. Jeśli UseDefaultCredentials parametr ma truewartość , zmiana Credentials właściwości z DefaultCredentials (wartość ustawiona podczas UseDefaultCredentials ustawiania właściwości na truewartość ) spowoduje zgłoszenie wyjątku.

Dotyczy