WebProxy.UseDefaultCredentials 屬性

定義

命名空間:

System.Net

組件:

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 屬性包含預設認證以外的認證時，您可以嘗試設定這個屬性。

備註

如果伺服器要求此物件的要求WebProxy，請使用目前登入使用者的認證進行驗證時，請將此屬性true設定為 。 對於用戶端應用程式，這是大部分情況下所需的行為。 對於中介層應用程式，例如 ASP.NET 應用程式，而不是使用此屬性，您通常會將 屬性設定 Credentials 為代表提出要求之客戶端的認證。

下表顯示根據 Credentials 屬性值設定UseDefaultCredentials值的效果。

Credentials 值	UseDefaultCredentials 值	效果
DefaultCredentials	true	沒有影響。
DefaultCredentials	false	Credentials 設定為 null。
null	true	Credentials 設定為 DefaultCredentials。
或以外的 DefaultCredentials 任何值 null	true 或 false	設定 UseDefaultCredentials 會擲回例外狀況。

如果 UseDefaultCredentials 為 false，您可以將 屬性變更 Credentials 為任何認證。 如果 為 trueUseDefaultCredentials ，則從 DefaultCredentials 變更 Credentials 屬性 (屬性設定true為) 時所設定UseDefaultCredentials的值將會擲回例外狀況。