Export (0) Print
Expand All

CredentialCache::Remove Method (Uri, String)

Deletes a NetworkCredential instance from the cache if it is associated with the specified Uniform Resource Identifier (URI) prefix and authentication protocol.

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

public:
void Remove(
	Uri^ uriPrefix, 
	String^ authType
)

Parameters

uriPrefix
Type: System::Uri

A Uri that specifies the URI prefix of the resources that the credential is used for.

authType
Type: System::String

The authentication scheme used by the host named in uriPrefix.

This method removes a NetworkCredential instance from the CredentialCache if the specified URI prefix and authentication protocol match those associated with the credential. Multiple calls to the Remove method for the same NetworkCredential have no effect.

If authType is nullptr or uriPrefix is nullptr, or no matching credential is found in the cache, this method does nothing.

The following code example uses this method to delete a NetworkCredential instance from the cache.

// Create a webrequest with the specified url.
WebRequest^ myWebRequest = WebRequest::Create( url );
myWebRequest->Credentials = myCredentialCache;
Console::WriteLine( "\nLinked CredentialCache to your request." );
// Send the request and wait for response.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Process response here.

Console::Write( "Response received successfully." );

// Call 'Remove' method to dispose credentials for current Uri as not required further.
myCredentialCache->Remove( myWebRequest->RequestUri, "Basic" );
Console::WriteLine( "\nYour credentials have now been removed from the program's CredentialCache" );
myWebResponse->Close();

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.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