CredentialCache.Remove 方法

定義

NetworkCredential 執行個體從快取中刪除。

多載

Remove(Uri, String)

從快取刪除 NetworkCredential 執行個體,如果它與所指定之統一資源識別元 (URI) 和驗證通訊協定關聯。

Remove(String, Int32, String)

從快取刪除 NetworkCredential 執行個體,如果它與所指定之主機、連接埠和驗證通訊協定關聯。

Remove(Uri, String)

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

從快取刪除 NetworkCredential 執行個體,如果它與所指定之統一資源識別元 (URI) 和驗證通訊協定關聯。

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

參數

uriPrefix
Uri

Uri,指定認證使用之資源的 URI 前置詞。

authType
String

由在 uriPrefix 中命名的主機所使用的驗證配置。

範例

下列程式代碼範例會使用這個方法從快取中刪除 NetworkCredential 實例。

C#
// 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();

備註

如果指定的 URI 前置詞和驗證通訊協定符合與認證相關聯的實例,這個方法就會 NetworkCredentialCredentialCache 中移除 實例。 相同 NetworkCredential 方法的Remove多個呼叫沒有任何作用。

如果 authType 為 或 uriPrefixnullnull ,或快取中找不到相符的認證,則此方法不會執行任何動作。

適用於

.NET 9 和其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Remove(String, Int32, String)

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

從快取刪除 NetworkCredential 執行個體,如果它與所指定之主機、連接埠和驗證通訊協定關聯。

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

參數

host
String

識別主機電腦的 String

port
Int32

Int32,指定 host 上的連接埠。

authenticationType
String

String,識別連接到 host 時,所使用的驗證配置。

備註

如果指定的主機、埠和驗證通訊協定符合與認證相關聯的實例,這個方法就會從 CredentialCache 中移除 NetworkCredential 實例。 相同 NetworkCredential 方法的Remove多個呼叫沒有任何作用。

如果 authType 為 或 uriPrefixnullnull ,或快取中找不到相符的認證,則此方法不會執行任何動作。

適用於

.NET 9 和其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0