CredentialCache::Add Method (Uri^, String^, NetworkCredential^)
Adds a NetworkCredential instance to the credential cache for use with protocols other than SMTP and associates it with a Uniform Resource Identifier (URI) prefix and authentication protocol.
Assembly: System (in System.dll)
Parameters
- uriPrefix
-
Type:
System::Uri^
A Uri that specifies the URI prefix of the resources that the credential grants access to.
- authType
-
Type:
System::String^
The authentication scheme used by the resource named in uriPrefix.
- cred
-
Type:
System.Net::NetworkCredential^
The NetworkCredential to add to the credential cache.
| Exception | Condition |
|---|---|
| ArgumentNullException | uriPrefix is null. -or- authType is null. |
| ArgumentException | The same credentials are added more than once. |
The Add method places a NetworkCredential instance for use with protocols other than SMTP into the CredentialCache. The cache stores credentials in the order in which they are added to it. When the GetCredential(Uri^, String^) method is called, it returns the proper matching NetworkCredential instance.
The following code example initializes a CredentialCache with multiple security credentials and uses those credentials with a 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;
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.1
Windows Phone
Available since 8.1