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
)
public void Remove (
	Uri uriPrefix, 
	String authType
)
public function Remove (
	uriPrefix : Uri, 
	authType : String
)
Not applicable.

Parameters

uriPrefix

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

authType

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 a null reference (Nothing in Visual Basic) or uriPrefix is a null reference (Nothing in Visual Basic), 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();

// Create a webrequest with the specified url. 
WebRequest myWebRequest = WebRequest.Create(url);
myWebRequest.set_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.get_RequestUri(), "Basic");
Console.WriteLine("\nYour credentials have now been removed "
    + "from the program's CredentialCache");
myWebResponse.Close();

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft