CredentialCache::Add Method (Uri^, String^, NetworkCredential^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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.

Namespace:   System.Net
Assembly:  System (in System.dll)

void Add(
	Uri^ uriPrefix,
	String^ authType,
	NetworkCredential^ cred


Type: System::Uri^

A Uri that specifies the URI prefix of the resources that the credential grants access to.

Type: System::String^

The authentication scheme used by the resource named in uriPrefix.

Type: System.Net::NetworkCredential^

The NetworkCredential to add to the credential cache.

Exception Condition

uriPrefix is null.


authType is null.


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( "" ), "Basic", gcnew NetworkCredential( UserName,SecurelyStoredPassword ) );
myCache->Add( gcnew Uri( "" ), "Digest", gcnew NetworkCredential( UserName,SecurelyStoredPassword,Domain ) );

wReq->Credentials = myCache;

Universal Windows Platform
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
Return to top