CredentialCache.Add メソッド
NetworkCredential インスタンスを資格情報キャッシュに追加します。
Public Sub Add( _
ByVal uriPrefix As Uri, _ ByVal authType As String, _ ByVal cred As NetworkCredential _)
[C#]
public void Add(UriuriPrefix,stringauthType,NetworkCredentialcred);
[C++]
public: void Add(Uri* uriPrefix,String* authType,NetworkCredential* cred);
[JScript]
public function Add(
uriPrefix : Uri,authType : String,cred : NetworkCredential);
パラメータ
- uriPrefix
資格情報によってアクセスが許可されるリソースの URI プリフィックスを指定する Uri 。 - authType
uriPrefix で指定されたリソースが使用する認証方式。 - cred
資格情報キャッシュに追加する NetworkCredential 。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentNullException | uriPrefix が null 参照 (Visual Basic では Nothing)
または authType が null 参照 (Nothing) です。 |
| ArgumentException | 同じ資格情報が 2 回以上追加されました。 |
解説
Add メソッドは、 NetworkCredential インスタンスを CredentialCache に配置します。キャッシュは、追加された順序で資格情報を格納します。 GetCredential メソッドを呼び出すと、一致する適切な NetworkCredential インスタンスが返されます。
使用例
[Visual Basic, C#, C++] 複数のセキュリティ資格情報で CredentialCache を初期化し、それらの資格情報を WebRequest で使用する例を次に示します。
Dim myCache As New CredentialCache()
myCache.Add(New Uri("https://www.contoso.com/"), "Basic", New NetworkCredential(UserName, SecurelyStoredPassword))
myCache.Add(New Uri("https://www.contoso.com/"), "Digest", New NetworkCredential(UserName, SecurelyStoredPassword, Domain))
wReq.Credentials = myCache
[C#]
CredentialCache myCache = new CredentialCache();
myCache.Add(new Uri("https://www.contoso.com/"),"Basic",new NetworkCredential(UserName,SecurelyStoredPassword));
myCache.Add(new Uri("https://www.contoso.com/"),"Digest", new NetworkCredential(UserName,SecurelyStoredPassword,Domain));
wReq.Credentials = myCache;
[C++]
CredentialCache* myCache = new CredentialCache();
myCache->Add(new Uri(S"https://www.contoso.com/"),S"Basic",new NetworkCredential(UserName,SecurelyStoredPassword));
myCache->Add(new Uri(S"https://www.contoso.com/"),S"Digest", new NetworkCredential(UserName,SecurelyStoredPassword,Domain));
wReq->Credentials = myCache;
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, Common Language Infrastructure (CLI) Standard