CredentialCache.GetCredential Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Primitives.dll

Retourne une instance de NetworkCredential associée à un URI (Uniform Resource Identifie) ou hôte spécifié, ainsi qu’un type d’authentification.

Surcharges

GetCredential(Uri, String)	Retourne l’instance de NetworkCredential associée à l’URI (Uniform Resource Identifier) et au type d’authentification spécifiés.
GetCredential(String, Int32, String)	Retourne l’instance de NetworkCredential associée à l’hôte, au port et au protocole d’authentification spécifiés.

GetCredential(Uri, String)

Source:

CredentialCache.cs

Retourne l’instance de NetworkCredential associée à l’URI (Uniform Resource Identifier) et au type d’authentification spécifiés.

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

Paramètres

uriPrefix

Uri

Uri qui spécifie le préfixe URI des ressources auxquelles les informations d’identification autorisent l’accès.

authType

String

Schéma d'authentification utilisé par la ressource nommée dans uriPrefix.

Retours

NetworkCredential

NetworkCredential ou, s’il n’existe aucune information d’identification correspondante dans le cache, null.

Implémente

GetCredential(Uri, String)

Exceptions

ArgumentNullException

uriPrefix ou authType est null.

Exemples

L’exemple de code suivant utilise la GetCredential(Uri, String) méthode pour retourner le NetworkCredential instance associé au type d’URI et d’authentification spécifiés.

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

Remarques

La GetCredential(Uri, String) méthode recherche le CredentialCache et retourne le NetworkCredential instance pour l’URI et le type d’autorisation spécifiés. Si ne CredentialCache contient aucune instance correspondante NetworkCredential , null est retourné.

GetCredential utilise le préfixe d’URI correspondant le plus long dans le cache pour déterminer l’ensemble d’informations d’identification à retourner pour un type d’autorisation. Le tableau suivant contient des exemples.

Préfixe d’URI	Correspond à
http://www.contoso.com/portal/news.htm	Demandes pour la page news.htmWeb spécifique.
http://www.contoso.com/portal/	Demandes pour tout le contenu du chemin d’accès portal , à l’exception de la page news.htm.
http://www.contoso.com/	Demandes pour toutes les ressources sur , à www.contoso.coml’exception de celles dans le chemin d’accès portal .

GetCredential(String, Int32, String)

Source:

CredentialCache.cs

Retourne l’instance de NetworkCredential associée à l’hôte, au port et au protocole d’authentification spécifiés.

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

Paramètres

host

String

String qui identifie l’ordinateur hôte.

port

Int32

Int32 qui spécifie le port auquel se connecter sur host

authenticationType

String

String qui identifie le schéma d'authentification utilisé lors de la connexion à host.

Retours

NetworkCredential

NetworkCredential ou, s’il n’existe aucune information d’identification correspondante dans le cache, null.

Implémente

GetCredential(String, Int32, String)

Exceptions

ArgumentNullException

host a la valeur null.

-ou-

authType a la valeur null.

ArgumentException

authType n’est pas une valeur admise.

- ou -

host est égal à la chaîne vide ("").

ArgumentOutOfRangeException

port est inférieur à zéro.

Remarques

Cette méthode recherche et CredentialCache retourne le NetworkCredential instance pour l’hôte, le port et le type d’autorisation spécifiés. Les hostvaleurs , portet authType passées à cette méthode ne respectent pas la casse par rapport aux valeurs spécifiées lors de l’ajout des informations d’identification à l’aide CredentialCache des Add méthodes .

Les valeurs prises en charge pour authType sont « NTLM », « Digest », « Kerberos » et « Negotiate ».