WebClient.Credentials Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

Obtient ou définit les informations d'identification réseau envoyées à l'hôte et utilisées pour authentifier la demande.

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

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é

ICredentials

ICredentials contenant les informations 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 Credentials propriété 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 les DefaultCredentials, qui sont les informations d’identification de l’utilisateur actuellement connecté. Pour ce faire, définissez la UseDefaultCredentials propriété sur true au lieu de définir cette propriété.

Si la WebClient classe est utilisée dans une application de niveau intermédiaire, telle qu’une application ASP.NET, le DefaultCredentials appartient au compte exécutant la page ASP (les 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 au nom 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-les à cette propriété. Cette propriété est automatiquement définie sur lors de null la redirection si elle contient autre chose qu’un CredentialCache. Le fait que cette valeur de propriété soit automatiquement définie sur null dans ces conditions empêche les informations d’identification d’être envoyées à une destination inattendue.

Voir aussi

• NetworkCredential
• CredentialCache
• Credentials