CredentialCache 類別

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.Primitives.dll

來源:

CredentialCache.cs

提供多個認證的記憶體。

public ref class CredentialCache : System::Collections::IEnumerable, System::Net::ICredentials, System::Net::ICredentialsByHost

public class CredentialCache : System.Collections.IEnumerable, System.Net.ICredentials, System.Net.ICredentialsByHost

type CredentialCache = class
    interface IEnumerable
    interface ICredentials
    interface ICredentialsByHost

Public Class CredentialCache
Implements ICredentials, ICredentialsByHost, IEnumerable

繼承

Object

CredentialCache

實作

IEnumerable ICredentials ICredentialsByHost

範例

以下程式碼範例初始 CredentialCache 化多個安全憑證，並使用這些憑證與 WebRequest。

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com/"),"Basic",new NetworkCredential(UserName,SecurelyStoredPassword));
myCache.Add(new Uri("http://www.contoso.com/"),"Digest", new NetworkCredential(UserName,SecurelyStoredPassword,Domain));

wReq.Credentials = myCache;

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com/"), "Basic", New NetworkCredential(UserName, SecurelyStoredPassword))
myCache.Add(New Uri("http://www.contoso.com/"), "Digest", New NetworkCredential(UserName, SecurelyStoredPassword, Domain))

wReq.Credentials = myCache

備註

該 CredentialCache 類別會儲存多個網際網路資源的憑證。 需要存取多個資源的應用程式，可以在一個實例中儲存這些資源 CredentialCache 的憑證，並在需要時提供適當的憑證給網際網路資源。 當呼叫該 GetCredential 方法時，它會將所提供的統一資源識別碼（URI）與快取中儲存的認證類型進行比較，並回傳第一組符合的憑證。

該 DefaultCredentials 屬性包含當前安全情境的系統憑證。 對於用戶端應用程式，這些代表目前登入使用者的使用者名稱、密碼及網域。 對於 ASP.NET 應用程式，預設憑證是登入使用者或被冒充使用者的使用者憑證。

建構函式

名稱	Description
CredentialCache()	建立一個新的類別實例 CredentialCache 。

屬性

名稱	Description
DefaultCredentials	取得應用程式的系統憑證。
DefaultNetworkCredentials	取得當前安全情境的網路憑證。

方法

名稱	Description
Add(String, Int32, String, NetworkCredential)	NetworkCredential將一個用於 SMTP 的實例加入憑證快取，並將其與主機電腦、埠號及認證協定關聯。 使用此方法新增的憑證僅適用於 SMTP。 此方法無法用於 HTTP 或 FTP 請求。
Add(Uri, String, NetworkCredential)	將 NetworkCredential 一個實例加入憑證快取，用於非 SMTP 協定，並與統一資源識別碼（URI）前綴及認證協定關聯。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetCredential(String, Int32, String)	回傳 NetworkCredential 與指定主機、埠號及認證協定相關聯的實例。
GetCredential(Uri, String)	回傳 NetworkCredential 與指定的統一資源識別碼（URI）及認證類型的實例。
GetEnumerator()	回傳一個枚舉器，可以遍歷該 CredentialCache 實例。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Remove(String, Int32, String)	若實例與指定的主機、埠及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。
Remove(Uri, String)	若該實例與指定的統一資源識別碼（URI）前綴及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

擴充方法

名稱	Description
AsParallel(IEnumerable)	啟用查詢的平行處理。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。
Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別篩選 IEnumerable 的專案。

另請參閱

• ICredentials
• Credentials