CredentialCache::GetCredential Method (String^, Int32, String^)


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

Returns the NetworkCredential instance associated with the specified host, port, and authentication protocol.

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

virtual NetworkCredential^ GetCredential(
	String^ host,
	int port,
	String^ authenticationType
) sealed


Type: System::String^

A String that identifies the host computer.

Type: System::Int32

A Int32 that specifies the port to connect to on host.

Type: System::String^

A String that identifies the authentication scheme used when connecting to host. See Remarks.

Return Value

Type: System.Net::NetworkCredential^

A NetworkCredential or, if there is no matching credential in the cache, null.

Exception Condition

host is null.


authType is null.


authType not an accepted value. See Remarks.


host is equal to the empty string ("").


port is less than zero.

This method searches the CredentialCache and returns the NetworkCredential instance for the specified host, port, and authorization type. The host, port, and authType values passed to this method are case-insensitively compared to the values specified when the credential was added to the CredentialCache using the Add methods.

The supported values for authType are "NTLM", "Digest", "Kerberos", and "Negotiate".

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.1
Windows Phone
Available since 8.1
Return to top