WebClient.Credentials Propriété

public:
 property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };

public System.Net.ICredentials? Credentials { get; set; }

public System.Net.ICredentials Credentials { get; set; }

member this.Credentials : System.Net.ICredentials with get, set

Public Property Credentials As ICredentials

Valeur de propriété

Une ICredentials contenant les informations d’identification d’authentification pour la demande. La valeur par défaut est null.

Exemples

L’exemple de code suivant utilise les informations d’identification système de l’utilisateur pour authentifier une demande.

int main()
{
   try
   {
      WebClient^ client = gcnew WebClient;
      client->Credentials = CredentialCache::DefaultCredentials;
      array<Byte>^pageData = client->DownloadData( "http://www.contoso.com" );
      String^ pageHtml = Encoding::ASCII->GetString( pageData );
      Console::WriteLine( pageHtml );
   }
   catch ( WebException^ webEx ) 
   {
      Console::Write( webEx );
   }

}

public static void Main()
{           
    try {

        WebClient client = new WebClient();

        client.Credentials = CredentialCache.DefaultCredentials;

        Byte[] pageData = client.DownloadData("http://www.contoso.com");
        string pageHtml = Encoding.ASCII.GetString(pageData);
        Console.WriteLine(pageHtml);
    } catch (WebException webEx) {
        Console.Write(webEx.ToString());
    }
}    

Public Shared Sub Main()
    Try
        Dim client As New WebClient()

        client.Credentials = CredentialCache.DefaultCredentials

        Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
        Dim pageHtml As String = Encoding.ASCII.GetString(pageData)
        
        Console.WriteLine(pageHtml)

    Catch webEx As WebException
        Console.Write(webEx.ToString())
    End Try
End Sub 

Remarques

La propriété Credentials contient les informations d’identification d’authentification utilisées pour accéder à une ressource sur un hôte. Dans la plupart des scénarios côté client, vous devez utiliser le DefaultCredentials, qui sont les informations d’identification de l’utilisateur actuellement connecté. Pour ce faire, définissez la propriété UseDefaultCredentials sur true au lieu de définir cette propriété.

Si la classe WebClient est utilisée dans une application de niveau intermédiaire, telle qu’une application ASP.NET, l'DefaultCredentials appartient au compte exécutant la page ASP (informations d’identification côté serveur). En règle générale, vous définissez cette propriété sur les informations d’identification du client pour le compte duquel la demande est effectuée.

Pour des raisons de sécurité, lorsque vous suivez automatiquement les redirections, stockez les informations d’identification que vous souhaitez inclure dans la redirection dans un CredentialCache et affectez-la à cette propriété. Cette propriété est automatiquement définie sur null lors de la redirection si elle contient quoi que ce soit à l’exception d’un CredentialCache. Si cette valeur de propriété est automatiquement définie sur null dans ces conditions, les informations d’identification ne peuvent pas être envoyées à une destination inattendue.

S’applique à

Voir aussi

• NetworkCredential
• CredentialCache
• Credentials