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

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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)

public:
void Add(
	Uri^ uriPrefix,
	String^ authType,
	NetworkCredential^ cred
)

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;

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
Show: