CredentialCache.GetCredential Método

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma instância NetworkCredential associada a um URI (Uniform Resource Identifier) ou host e ao tipo de autenticação especificados.

Sobrecargas

GetCredential(Uri, String)	Retorna a instância NetworkCredential associada ao URI (Uniform Resource Identifier) e ao tipo de autenticação especificados.
GetCredential(String, Int32, String)	Retorna a instância NetworkCredential associada ao host, a porta e o protocolo de autenticação especificados.

GetCredential(Uri, String)

Retorna a instância NetworkCredential associada ao URI (Uniform Resource Identifier) e ao tipo de autenticação especificados.

public:
 virtual System::Net::NetworkCredential ^ GetCredential(Uri ^ uriPrefix, System::String ^ authType);

public System.Net.NetworkCredential GetCredential (Uri uriPrefix, 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

Parâmetros

uriPrefix: Uri

Um Uri que especifica o prefixo URI dos recursos aos quais a credencial concede acesso.

authType: String

O esquema de autenticação usado pelo recurso nomeado no uriPrefix.

Retornos

NetworkCredential

Um NetworkCredential ou, se não houver nenhuma credencial correspondente no cache, null.

Implementações

GetCredential(Uri, String)

Exceções

ArgumentNullException

uriPrefix ou authType é null.

Exemplos

O exemplo de código a seguir usa o GetCredential(Uri, String) método para retornar a NetworkCredential instância associada ao URI e ao tipo de autenticação especificados.

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

Comentários

O GetCredential(Uri, String) método pesquisa e CredentialCache retorna a NetworkCredential instância para o URI e o tipo de autorização especificados. Se a CredentialCache instância não contiver correspondência NetworkCredential , null será retornada.

GetCredential usa o prefixo de URI correspondente mais longo no cache para determinar qual conjunto de credenciais retornar para um tipo de autorização. A tabela a seguir mostra exemplos.

Prefixo de URI	Corresponde a
`http://www.contoso.com/portal/news.htm`	Solicitações para a página `news.htm`da Web específica.
`http://www.contoso.com/portal/`	Solicitações para todo o `portal` conteúdo no caminho, exceto a página `news.htm`.
`http://www.contoso.com/`	Solicitações para todos os recursos, `www.contoso.com`exceto aqueles no `portal` caminho.

Aplica-se a

GetCredential(String, Int32, String)

Retorna a instância NetworkCredential associada ao host, a porta e o protocolo de autenticação especificados.

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);

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

Parâmetros

host: String

Um String que identifica o computador host.

port: Int32

Um Int32 que especifica a porta para conectar-se no host.

authenticationType: String

Um String que identifica o esquema de autenticação usado ao conectar-se ao host.

Retornos

NetworkCredential

Um NetworkCredential ou, se não houver nenhuma credencial correspondente no cache, null.

Implementações

GetCredential(String, Int32, String)

Exceções

ArgumentNullException

host é null.

- ou - authType é null.

ArgumentException

authType não é um valor aceito.

- ou - host é igual à cadeia de caracteres vazia ("").

ArgumentOutOfRangeException

port é menor que zero.

Comentários

Esse método pesquisa e CredentialCache retorna a NetworkCredential instância para o tipo de host, porta e autorização especificados. Os hostvalores e port``authType valores passados para esse método não diferenciam maiúsculas de minúsculas em comparação com os valores especificados quando a credencial foi adicionada ao uso dos Add CredentialCache métodos.

Os valores com suporte são authType "NTLM", "Digest", "Kerberos" e "Negotiate".

Aplica-se a

CredentialCache.GetCredential Método

Definição

Sobrecargas

GetCredential(Uri, String)

Parâmetros

Retornos

Implementações

Exceções

Exemplos

Comentários

Aplica-se a

GetCredential(String, Int32, String)

Parâmetros

Retornos

Implementações

Exceções

Comentários

Aplica-se a

Recursos adicionais