AuthenticationManager.CredentialPolicy 屬性

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

AuthenticationManager.cs

取得或設定用於資源要求 (使用 HttpWebRequest 類別所提出) 的認證原則。

public:
 static property System::Net::ICredentialPolicy ^ CredentialPolicy { System::Net::ICredentialPolicy ^ get(); void set(System::Net::ICredentialPolicy ^ value); };

public static System.Net.ICredentialPolicy? CredentialPolicy { get; set; }

static member CredentialPolicy : System.Net.ICredentialPolicy with get, set

Public Shared Property CredentialPolicy As ICredentialPolicy

屬性值

ICredentialPolicy

實作 ICredentialPolicy 介面的物件，判斷認證是否與要求一起傳送。 預設值是 null。

範例

下列程式代碼範例示範如何設定認證原則。

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

備註

認證原則會決定是否要在傳送網路資源的要求時傳送認證，例如網頁的內容。 如果傳送認證，要求客戶端驗證的伺服器可以在收到要求時嘗試驗證用戶端，而不是傳送回應，指出需要客戶端的認證。 雖然這可節省伺服器的來回行程，但這必須與透過網路傳送認證時固有的安全性風險進行平衡。 當目的地伺服器不需要客戶端驗證時，最好不要傳送認證。

認證原則只會針對指定認證的要求呼叫，或使用 WebProxy 指定認證的物件。