Export (0) Print
Expand All

CredentialCache.GetCredential Method (String, Int32, String)

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

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

abstract GetCredential : 
        host:string * 
        port:int * 
        authenticationType:string -> NetworkCredential  
override GetCredential : 
        host:string * 
        port:int * 
        authenticationType:string -> NetworkCredential

Parameters

host
Type: System.String

A String that identifies the host computer.

port
Type: System.Int32

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

authenticationType
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, a null reference (Nothing in Visual Basic).

Implements

ICredentialsByHost.GetCredential(String, Int32, String)

ExceptionCondition
ArgumentNullException

host is a null reference (Nothing in Visual Basic).

-or-

authType is a null reference (Nothing in Visual Basic).

ArgumentException

authType not an accepted value. See Remarks.

-or-

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

ArgumentOutOfRangeException

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".

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft