CredentialCache.GetCredential 方法

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

傳回與所指定之統一資源識別元 (URI) 或主機以及驗證類型關聯的 NetworkCredential 執行個體。

多載

GetCredential(Uri, String)	傳回與所指定之統一資源識別項 (URI) 和驗證類型關聯的 NetworkCredential 執行個體。
GetCredential(String, Int32, String)	傳回與指定主機、連接埠和驗證通訊協定關聯的 NetworkCredential 執行個體。

GetCredential(Uri, String)

來源:

CredentialCache.cs

傳回與所指定之統一資源識別項 (URI) 和驗證類型關聯的 NetworkCredential 執行個體。

C#

public System.Net.NetworkCredential? GetCredential (Uri uriPrefix, string authType);

參數

uriPrefix

Uri

Uri，指定認證允許存取之資源的 URI 前置詞。

authType

String

驗證配置，由在 uriPrefix 中指名的資源所使用。

傳回

NetworkCredential

NetworkCredential，或 null (如果在快取中沒有相符的認證)。

實作

GetCredential(Uri, String)

例外狀況

ArgumentNullException

uriPrefix 或 authType 為 null。

範例

下列程式代碼範例會 GetCredential(Uri, String) 使用 方法來傳回 NetworkCredential 與指定 URI 和驗證類型相關聯的實例。

C#

  public static void GetPage(string url,string userName,string password,string domainName)
  {
      try
      {
          CredentialCache myCredentialCache = new CredentialCache();
          // Dummy names used as credentials.
          myCredentialCache.Add(new Uri("http://microsoft.com/"),"Basic", new NetworkCredential("user1","passwd1","domain1"));
          myCredentialCache.Add(new Uri("http://msdn.com/"),"Basic", new NetworkCredential("user2","passwd2","domain2"));
          myCredentialCache.Add(new Uri(url),"Basic", new NetworkCredential(userName,password,domainName));
          // Create a webrequest with the specified url.
       WebRequest myWebRequest = WebRequest.Create(url);
          // Call 'GetCredential' to obtain the credentials specific to our Uri.
          NetworkCredential myCredential = myCredentialCache.GetCredential(new Uri(url),"Basic");
          Display(myCredential);
       // Associating only our credentials.
          myWebRequest.Credentials = myCredential;
          // Sends the request and waits for response.
       WebResponse myWebResponse = myWebRequest.GetResponse();

          // Process response here.

       Console.WriteLine("\nResponse Received.");
          myWebResponse.Close();
      }
      catch(WebException e)
      {
          if (e.Response != null)
              Console.WriteLine("\r\nFailed to obtain a response. The following error occurred : {0}",((HttpWebResponse)(e.Response)).StatusDescription);
          else
              Console.WriteLine("\r\nFailed to obtain a response. The following error occurred : {0}",e.Status);
      }
      catch(Exception e)
      {
          Console.WriteLine("\nThe following exception was raised : {0}",e.Message);
      }
}
public static void Display(NetworkCredential credential)
{
  Console.WriteLine("\nThe credentials are:");
  Console.WriteLine("\nUsername : {0} ,Password : {1} ,Domain : {2}",credential.UserName,credential.Password,credential.Domain);
}

備註

方法會 GetCredential(Uri, String) 搜尋 CredentialCache ，並傳回 NetworkCredential 指定的 URI 和授權類型的實例。 CredentialCache如果 不包含相符NetworkCredential的實體，null則會傳回 。

GetCredential 會使用快取中最長相符的 URI 前置詞來判斷要針對授權類型傳回的認證集。 下表顯示範例。

URI 前置詞	相符項
http://www.contoso.com/portal/news.htm	特定網頁 news.htm的要求。
http://www.contoso.com/portal/	要求路徑中的所有 portal 內容，但頁面 news.htm除外。
http://www.contoso.com/	要求位於 www.contoso.com的所有資源，但路徑中的 portal 資源除外。

GetCredential(String, Int32, String)

來源:

CredentialCache.cs

傳回與指定主機、連接埠和驗證通訊協定關聯的 NetworkCredential 執行個體。

C#

public System.Net.NetworkCredential? GetCredential (string host, int port, string authenticationType);

參數

host

String

識別主機電腦的 String。

port

Int32

Int32，指定 host 上的連接埠。

authenticationType

String

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

傳回

NetworkCredential

NetworkCredential，或 null (如果在快取中沒有相符的認證)。

實作

GetCredential(String, Int32, String)

例外狀況

ArgumentNullException

host 為 null。

-或-

authType 為 null。

ArgumentException

authType 不是接受的值。

-或-

host 等於空字串 ("")。

ArgumentOutOfRangeException

port 小於零。

備註

這個方法會 CredentialCache 搜尋 ，並傳回 NetworkCredential 指定的主機、埠和授權類型的實例。 傳遞至這個方法的host、 port和 authType 值與使用 Add 方法新增CredentialCache認證時所指定的值不區分大小寫。

的支援值為 authType “NTLM”、“Digest”、“Kerberos” 和 “Negotiate”。