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 Sub Remove (
	uriPrefix As Uri,
	authType As String
)

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 null or uriPrefix is null, 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 .
Dim myWebRequest As WebRequest = WebRequest.Create(url)
myWebRequest.Credentials = myCredentialCache
Console.WriteLine(ControlChars.Cr + "Linked CredentialCache to your request.")
' Send the request and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

'Process the response here

Console.Write("Response received successfully.")
'Call 'Remove' method to dispose credentials for current Uri as they would not be; 
'required in any of the future requests.
myCredentialCache.Remove(myWebRequest.RequestUri, "Basic")
Console.WriteLine(ControlChars.Cr + "Your credentials have now been removed from the program's CredentialCache")
myWebResponse.Close()

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: