CredentialCache.Remove 方法

定義

命名空間:
System.Net
組件:
System.dll, System.Net.Primitives.dll
組件:
netstandard.dll, System.Net.Primitives.dll
組件:
System.Net.Primitives.dll
組件:
System.dll
組件:
netstandard.dll

從快取中刪除一個 NetworkCredential 實例。

多載

名稱 Description
Remove(Uri, String)

若該實例與指定的統一資源識別碼（URI）前綴及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。
Remove(String, Int32, String)

若實例與指定的主機、埠及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。

Remove(Uri, String)

來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs

若該實例與指定的統一資源識別碼（URI）前綴及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。

public:
 void Remove(Uri ^ uriPrefix, System::String ^ authType);
public void Remove(Uri uriPrefix, string authType);
public void Remove(Uri? uriPrefix, string? authType);
member this.Remove : Uri * string -> unit
Public Sub Remove (uriPrefix As Uri, authType As String)

參數

uriPrefix
Uri

A Uri 用來指定該憑證所用資源的 URI 前綴。

authType
String

主機所使用的 uriPrefix認證方案。

範例

以下程式碼範例使用此方法從快取中刪除實 NetworkCredential 例。

// 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()

備註

此方法若指定的 URI 前綴與認證協定與憑證相關聯相符，則會移除實 NetworkCredential 例 CredentialCache 。 多次呼叫該 Remove 方法對同一 NetworkCredential 結果都沒有影響。

如果 authType 是 或 nulluriPrefix ， null或快取中找不到匹配的憑證，此方法將不做任何事。

適用於

Remove(String, Int32, String)

來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs
來源:
CredentialCache.cs

若實例與指定的主機、埠及認證協定相關聯，則會從 NetworkCredential 快取中刪除該實例。

public:
 void Remove(System::String ^ host, int port, System::String ^ authenticationType);
public void Remove(string host, int port, 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)

參數

host
String

A String 用來識別主機電腦。

port
Int32

Int32 A 指定要連接的host埠。

authenticationType
String

A String 用來識別連接 host時所使用的認證方案。

備註

此方法若指定的主機、埠號及認證協定與憑證相關聯，則會移除該 NetworkCredential 實例 CredentialCache 。 多次呼叫該 Remove 方法對同一 NetworkCredential 結果都沒有影響。

如果 authenticationType 是 或 nulluriPrefix ， null或快取中找不到匹配的憑證，此方法將不做任何事。

適用於