CredentialCache.GetCredential Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Net

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce un'istanza di NetworkCredential associata a un URI (Uniform Resource Identifier) oppure a un host e a un tipo di autenticazione specificati.

Overload

GetCredential(Uri, String)	Restituisce l'istanza NetworkCredential associata al tipo di autenticazione e all'URI specificati.
GetCredential(String, Int32, String)	Restituisce l'istanza di NetworkCredential associata all'host, alla porta e al protocollo di autenticazione specificati.

GetCredential(Uri, String)

Origine:: CredentialCache.cs

Origine:: CredentialCache.cs

Origine:: CredentialCache.cs

Restituisce l'istanza NetworkCredential associata al tipo di autenticazione e all'URI specificati.

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

Parametri

uriPrefix: Uri

Un Uri che specifica il prefisso URI delle risorse a cui la credenziale concede l'accesso.

authType: String

Lo schema di autenticazione utilizzato dalla risorsa specificata in uriPrefix.

Restituisce

NetworkCredential

Una NetworkCredential oppure null se non esistono credenziali corrispondenti nella cache.

Implementazioni

GetCredential(Uri, String)

Eccezioni

ArgumentNullException

uriPrefix o authType è null.

Esempio

Nell'esempio di codice seguente viene utilizzato il GetCredential(Uri, String) metodo per restituire l'istanza associata all'URI NetworkCredential e al tipo di autenticazione specificati.

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

Commenti

Il GetCredential(Uri, String) metodo cerca e CredentialCache restituisce l'istanza per l'URI NetworkCredential e il tipo di autorizzazione specificati. Se l'oggetto non contiene un'istanza CredentialCache corrispondente NetworkCredential , null viene restituito .

GetCredential usa il prefisso URI corrispondente più lungo nella cache per determinare quale set di credenziali restituire per un tipo di autorizzazione. La tabella seguente mostra esempi.

Prefisso URI	Corrispondenze
`http://www.contoso.com/portal/news.htm`	Richieste per la pagina `news.htm`Web specifica.
`http://www.contoso.com/portal/`	Richiede tutto il contenuto nel `portal` percorso, ad eccezione della pagina `news.htm`.
`http://www.contoso.com/`	Richieste per tutte le risorse in `www.contoso.com`, ad eccezione di quelle nel `portal` percorso.

Si applica a

GetCredential(String, Int32, String)

Origine:: CredentialCache.cs

Origine:: CredentialCache.cs

Origine:: CredentialCache.cs

Restituisce l'istanza di NetworkCredential associata all'host, alla porta e al protocollo di autenticazione specificati.

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

Parametri

host: String

Oggetto String che identifica il computer host.

port: Int32

Oggetto Int32 che specifica la porta per connettersi a un host.

authenticationType: String

Oggetto String che identifica lo schema di autenticazione utilizzato durante la connessione a host.

Restituisce

NetworkCredential

Una NetworkCredential oppure null se non esistono credenziali corrispondenti nella cache.

Implementazioni

GetCredential(String, Int32, String)

Eccezioni

ArgumentNullException

host è null.

-oppure-

authType è null.

ArgumentException

authType non è un valore accettato.

-oppure-

host è uguale alla stringa vuota ("").

ArgumentOutOfRangeException

port è minore di zero.

Commenti

Questo metodo cerca e CredentialCache restituisce l'istanza per l'host, la NetworkCredential porta e il tipo di autorizzazione specificati. I hostvalori , porte authType passati a questo metodo non fanno distinzione tra maiuscole e minuscole rispetto ai valori specificati quando la credenziale è stata aggiunta all'oggetto CredentialCache utilizzando i Add metodi .

I valori supportati per authType sono "NTLM", "Digest", "Kerberos" e "Negotiate".

Si applica a

Condividi tramite

CredentialCache.GetCredential Metodo

Definizione

Overload

GetCredential(Uri, String)

Parametri

Restituisce

Implementazioni

Eccezioni

Esempio

Commenti

Si applica a

GetCredential(String, Int32, String)

Parametri

Restituisce

Implementazioni

Eccezioni

Commenti

Si applica a

Risorse aggiuntive