CredentialCache.Remove Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Exclui uma instância NetworkCredential do cache.

Sobrecargas

Remove(Uri, String)	Exclui uma instância de NetworkCredential do cache se ela estiver associada com o protocolo de autenticação e o prefixo URI (identificador de recurso uniforme) especificado.
Remove(String, Int32, String)	Exclui uma instância de NetworkCredential do cache se ela estiver associada ao protocolo de autenticação, porta ou host especificado.

Remove(Uri, String)

Origem:

CredentialCache.cs

Exclui uma instância de NetworkCredential do cache se ela estiver associada com o protocolo de autenticação e o prefixo URI (identificador de recurso uniforme) especificado.

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

public void Remove (Uri? uriPrefix, string? authType);

member this.Remove : Uri * string -> unit

Public Sub Remove (uriPrefix As Uri, authType As String)

Parâmetros

uriPrefix

Uri

Um Uri que especifica o prefixo URI dos recursos para os quais a credencial é usada.

authType

String

O esquema de autenticação usado pelo host nomeado em uriPrefix.

Exemplos

O exemplo de código a seguir usa esse método para excluir uma NetworkCredential instância do 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.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 .
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()

Comentários

Esse método removerá uma NetworkCredential instância do CredentialCache se o prefixo de URI especificado e o protocolo de autenticação corresponderem aos associados à credencial. Várias chamadas para o Remove método para o mesmo NetworkCredential não têm efeito.

Se authType for null ou uriPrefix for null, ou nenhuma credencial correspondente for encontrada no cache, esse método não fará nada.

Remove(String, Int32, String)

Origem:

CredentialCache.cs

Exclui uma instância de NetworkCredential do cache se ela estiver associada ao protocolo de autenticação, porta ou host especificado.

public:
 void Remove(System::String ^ host, int port, System::String ^ authenticationType);

public void Remove (string? host, int port, string? authenticationType);

member this.Remove : string * int * string -> unit

Public Sub Remove (host As String, port As Integer, authenticationType As String)

Parâmetros

host

String

Um String que identifica o computador host.

port

Int32

Um Int32 que especifica a porta para conectar-se no host.

authenticationType

String

Um String que identifica o esquema de autenticação usado ao conectar-se ao host.

Comentários

Esse método remove uma NetworkCredential instância do CredentialCache se o host, a porta e o protocolo de autenticação especificados corresponderem aos associados à credencial. Várias chamadas para o Remove método para o mesmo NetworkCredential não têm efeito.

Se authType for null ou uriPrefix for null, ou nenhuma credencial correspondente for encontrada no cache, esse método não fará nada.