CredentialCache.GetCredential CredentialCache.GetCredential CredentialCache.GetCredential CredentialCache.GetCredential Method

Определение

Возвращает экземпляр NetworkCredential, связанный с указанным URI или узлом, а также с типом проверки подлинности.Returns a NetworkCredential instance associated with a specified Uniform Resource Identifier (URI) or host, and authentication type.

Перегрузки

GetCredential(Uri, String) GetCredential(Uri, String) GetCredential(Uri, String) GetCredential(Uri, String)

Возвращает экземпляр NetworkCredential, связанный с указанным URI или узлом, а также с типом проверки подлинности.Returns the NetworkCredential instance associated with the specified Uniform Resource Identifier (URI) and authentication type.

GetCredential(String, Int32, String) GetCredential(String, Int32, String) GetCredential(String, Int32, String) GetCredential(String, Int32, String)

Возвращает экземпляр NetworkCredential, связанный с заданными узлом, портом и протоколом проверки подлинности.Returns the NetworkCredential instance associated with the specified host, port, and authentication protocol.

GetCredential(Uri, String) GetCredential(Uri, String) GetCredential(Uri, String) GetCredential(Uri, String)

Возвращает экземпляр NetworkCredential, связанный с указанным URI или узлом, а также с типом проверки подлинности.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 Uri

Параметр Uri, определяющий префикс URI ресурсов, к которым предоставляется доступ посредством учетных данных.A Uri that specifies the URI prefix of the resources that the credential grants access to.

authType
String String String String

Схема проверки подлинности, которая используется ресурсом, названным в uriPrefix.The authentication scheme used by the resource named in uriPrefix.

Возвраты

Экземпляр NetworkCredential или, если в кэше нет соответствующих учетных данных, — null.A NetworkCredential or, if there is no matching credential in the cache, null.

Реализации

Исключения

Значение параметра uriPrefix или authTypenull.uriPrefix or authType is null.

Примеры

В следующем примере кода GetCredential(Uri, String) метод используется для NetworkCredential возврата экземпляра, связанного с указанным URI и типом проверки подлинности.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

Комментарии

Метод выполняет поиск NetworkCredential и возвращает экземпляр для указанного универсального кода ресурса (URI) и типа авторизации. CredentialCache GetCredential(Uri, String)The GetCredential(Uri, String) method searches the CredentialCache and returns the NetworkCredential instance for the specified URI and authorization type. Если объект CredentialCache не содержит соответствующего NetworkCredential экземпляра, null возвращается значение.If 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.

Префикс URIURI 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.htmRequests 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) GetCredential(String, Int32, String) GetCredential(String, Int32, String) 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 String String String

Объект String, определяющий компьютер.A String that identifies the host computer.

port
Int32 Int32 Int32 Int32

Значение Int32, которое обозначает порт, через который следует подключаться к host.A Int32 that specifies the port to connect to on host.

authenticationType
String String String String

Строка String, указывающая схему проверку подлинности, используемую при подключении к host.A String that identifies the authentication scheme used when connecting to host.

Возвраты

Экземпляр NetworkCredential или, если в кэше нет соответствующих учетных данных, — null.A NetworkCredential or, if there is no matching credential in the cache, null.

Реализации

Исключения

Свойство host имеет значение null.host is null.

-или--or- Свойство authType имеет значение null.authType 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. Add CredentialCache Значения host, port иauthType , передаваемые в этот метод, не чувствительны к регистру по сравнению со значениями, заданными при добавлении учетных данных в с помощью методов.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".

Применяется к