CredentialCache.GetCredential 方法

定义

返回与指定的统一资源标识符 (URI) 或主机和身份验证类型相关联的 NetworkCredential 实例。Returns a NetworkCredential instance associated with a specified Uniform Resource Identifier (URI) or host, and authentication type.

重载

GetCredential(Uri, String)

返回与指定的统一资源标识符 (URI) 和身份验证类型相关联的 NetworkCredential 实例。Returns the NetworkCredential instance associated with the specified Uniform Resource Identifier (URI) and authentication type.

GetCredential(String, Int32, String)

返回与指定的主机、端口和身份验证协议关联的 NetworkCredential 实例。Returns the NetworkCredential instance associated with the specified host, port, and authentication protocol.

GetCredential(Uri, String)

返回与指定的统一资源标识符 (URI) 和身份验证类型相关联的 NetworkCredential 实例。Returns the NetworkCredential instance associated with the specified Uniform Resource Identifier (URI) and authentication type.

public:
 virtual System::Net::NetworkCredential ^ GetCredential(Uri ^ uriPrefix, System::String ^ authType);
public System.Net.NetworkCredential GetCredential (Uri uriPrefix, string authType);
abstract member GetCredential : Uri * string -> System.Net.NetworkCredential
override this.GetCredential : Uri * string -> System.Net.NetworkCredential
Public Function GetCredential (uriPrefix As Uri, authType As String) As NetworkCredential

参数

uriPrefix
Uri

一个 Uri,它指定资源的 URI 前缀,该资源由凭据授予访问权。A Uri that specifies the URI prefix of the resources that the credential grants access to.

authType
String

uriPrefix 中命名的资源所使用的身份验证方案。The authentication scheme used by the resource named in uriPrefix.

返回

NetworkCredential;如果缓存中没有匹配的凭据,则为 nullA NetworkCredential or, if there is no matching credential in the cache, null.

实现

例外

uriPrefixauthTypenulluriPrefix or authType is null.

示例

下面的代码示例使用 GetCredential(Uri, String) 方法返回与指定 URI 和身份验证类型相关联的 NetworkCredential 实例。The following code example uses the GetCredential(Uri, String) method to return the NetworkCredential instance associated with the specified URI and authentication type.

void Display( NetworkCredential^ credential )
{
   Console::WriteLine( "\nThe credentials are:" );
   Console::WriteLine( "\nUsername : {0} , Password : {1} , Domain : {2}", credential->UserName, credential->Password, credential->Domain );
}

void GetPage( String^ url, String^ userName, String^ password, String^ domainName )
{
   try
   {
      CredentialCache^ myCredentialCache = gcnew CredentialCache;

      // Dummy names used as credentials.
      myCredentialCache->Add( gcnew Uri( "http://microsoft.com/" ), "Basic", gcnew NetworkCredential( "user1","passwd1","domain1" ) );
      myCredentialCache->Add( gcnew Uri( "http://msdn.com/" ), "Basic", gcnew NetworkCredential( "user2","passwd2","domain2" ) );
      myCredentialCache->Add( gcnew Uri( url ), "Basic", gcnew 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( gcnew 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 != nullptr )
            Console::WriteLine( "\r\nFailed to obtain a response. The following error occurred : {0}", (dynamic_cast<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 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);
}
Public Shared Sub GetPage(url As String, userName As String, password As String, domainName As String)
    Try
        Dim myCredentialCache As 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))
        ' Creates a webrequest with the specified url. 
        Dim myWebRequest As WebRequest = WebRequest.Create(url)
        ' Call 'GetCredential' to obtain the credentials specific to our Uri.
        Dim myCredential As NetworkCredential = myCredentialCache.GetCredential(New Uri(url), "Basic")
        Display(myCredential)
        myWebRequest.Credentials = myCredential 'Associating only our credentials            
        ' Sends the request and waits for response.
        Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
        ' Process response here.
        Console.WriteLine(ControlChars.Cr + "Response Received.")
        myWebResponse.Close()

    Catch e As WebException
        If Not (e.Response Is Nothing) Then
            Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "Failed to obtain a response. The following error occurred : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
        Else
            Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "Failed to obtain a response. The following error occurred : {0}", e.Status)
        End If
    Catch e As Exception
        Console.WriteLine(ControlChars.Cr + "The following exception was raised : {0}", e.Message)
    End Try
End Sub

Public Shared Sub Display(ByVal credential As NetworkCredential)
    Console.WriteLine("The credentials are: ")
    Console.WriteLine(ControlChars.Cr + "Username : {0} ,Password : {1} ,Domain : {2}", credential.UserName, credential.Password, credential.Domain)
End Sub

注解

GetCredential(Uri, String) 方法搜索 CredentialCache 并返回指定 URI 和授权类型的 NetworkCredential 实例。The GetCredential(Uri, String) method searches the CredentialCache and returns the NetworkCredential instance for the specified URI and authorization type. 如果 CredentialCache 不包含匹配的 NetworkCredential 实例,则返回 nullIf the CredentialCache contains no matching NetworkCredential instance, null is returned.

GetCredential 使用缓存中的最长匹配 URI 前缀来确定要为授权类型返回的凭据集。GetCredential uses the longest matching URI prefix in the cache to determine which set of credentials to return for an authorization type. 下表显示了示例。The following table shows examples.

URI 前缀URI Prefix 匹配Matches
http://www.contoso.com/portal/news.htm news.htm特定网页的请求。Requests for the specific Web page news.htm.
http://www.contoso.com/portal/ 请求 portal 路径中除页面 news.htm以外的所有内容。Requests for all content in the portal path, except the page news.htm.
http://www.contoso.com/ www.contoso.com上的所有资源(portal 路径中的资源除外)的请求。Requests for all resources at www.contoso.com, except those in the portal path.

GetCredential(String, Int32, String)

返回与指定的主机、端口和身份验证协议关联的 NetworkCredential 实例。Returns the NetworkCredential instance associated with the specified host, port, and authentication protocol.

public:
 virtual System::Net::NetworkCredential ^ GetCredential(System::String ^ host, int port, System::String ^ authenticationType);
public System.Net.NetworkCredential GetCredential (string host, int port, string authenticationType);
abstract member GetCredential : string * int * string -> System.Net.NetworkCredential
override this.GetCredential : string * int * string -> System.Net.NetworkCredential
Public Function GetCredential (host As String, port As Integer, authenticationType As String) As NetworkCredential

参数

host
String

标识主机的 StringA String that identifies the host computer.

port
Int32

指定要连接到 Int32 的端口的 hostA Int32 that specifies the port to connect to on host.

authenticationType
String

String,它标识连接到 host 时使用的身份验证方案。A String that identifies the authentication scheme used when connecting to host.

返回

NetworkCredential;如果缓存中没有匹配的凭据,则为 nullA NetworkCredential or, if there is no matching credential in the cache, null.

实现

例外

hostnullhost is null.

-或--or- authTypenullauthType is null.

authType 不是一个接受的值。authType not an accepted value.

-或--or- host 是空字符串 ("")。host is equal to the empty string ("").

port 小于零。port is less than zero.

注解

此方法搜索 CredentialCache,并返回指定的主机、端口和授权类型的 NetworkCredential 实例。This method searches the CredentialCache and returns the NetworkCredential instance for the specified host, port, and authorization type. 传递给此方法的 hostportauthType 值与使用 Add 方法添加到 CredentialCache 时指定的值相比较。The host, port, and authType values passed to this method are case-insensitively compared to the values specified when the credential was added to the CredentialCache using the Add methods.

authType 支持的值为 "NTLM"、"Digest"、"Kerberos" 和 "Negotiate"。The supported values for authType are "NTLM", "Digest", "Kerberos", and "Negotiate".

适用于