CredentialCache 類別

定義

命名空間:

System.Net

組件:

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 = gcnew CredentialCache;

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

wReq->Credentials = myCache;

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 應用程式，預設認證是已登入使用者或正在仿真的用戶認證。

建構函式

CredentialCache()

建立 CredentialCache 類別的新執行個體。

屬性

DefaultCredentials	取得應用程式的系統認證。
DefaultNetworkCredentials	取得目前安全性內容的網路認證。

方法

Add(String, Int32, String, NetworkCredential)	將要搭配 Simple Mail Transfer Protocol (SMTP) 使用的 NetworkCredential 執行個體加入至認證快取，並使其與主機電腦、連接埠和驗證通訊協定產生關聯。 使用此方法加入的認證只適用於 SMTP。 這個方法不適用於 HTTP 或 FTP 要求。
Add(Uri, String, NetworkCredential)	將要搭配 SMTP 以外其他通訊協定使用的 NetworkCredential 執行個體加入至認證快取，並使其與統一資源識別元 (URI) 和驗證通訊協定產生關聯。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetCredential(String, Int32, String)	傳回與指定主機、連接埠和驗證通訊協定關聯的 NetworkCredential 執行個體。
GetCredential(Uri, String)	傳回與所指定之統一資源識別項 (URI) 和驗證類型關聯的 NetworkCredential 執行個體。
GetEnumerator()	傳回可以逐一查看 CredentialCache 執行個體的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(String, Int32, String)	從快取刪除 NetworkCredential 執行個體，如果它與所指定之主機、連接埠和驗證通訊協定關聯。
Remove(Uri, String)	從快取刪除 NetworkCredential 執行個體，如果它與所指定之統一資源識別元 (URI) 和驗證通訊協定關聯。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

另請參閱

• ICredentials
• Credentials