WebRequest, classe

WebRequest est la classe de base abstract du modèle demande/réponse du .NET Framework pour l'accès aux données à partir d'Internet. Une application qui utilise le modèle demande/réponse peut demander des données à partir d'Internet de manière agnostique du protocole, dans lesquelles l'application utilise des instances de la classe WebRequest alors que les classes descendantes propres au protocole exécutent les détails de la demande.

Les demandes sont envoyées par une application vers un URI particulier, tel qu'une page Web sur un serveur. L'URI détermine la classe descendante appropriée à créer à partir d'une liste de descendants WebRequest inscrits pour l'application. Les descendants WebRequest sont généralement inscrits de façon à gérer un protocole spécifique, tel que HTTP ou FTP, mais ils peuvent également l'être pour gérer une demande envoyée vers un serveur ou un chemin d'accès sur un serveur spécifiques.

La classe WebRequest lève WebException lorsque des erreurs se produisent pendant l'accès à une ressource Internet. La propriété Status est une des valeurs WebExceptionStatus qui indique la source de l'erreur. Si Status est WebExceptionStatus.ProtocolError, la propriété Response contient le WebResponse reçu de la ressource Internet.

Comme la classe WebRequest est une classe abstract, le comportement réel des instances de WebRequest au moment de l'exécution est déterminé par la classe descendante retournée par la méthode Create. Pour plus d'informations sur les valeurs par défaut et les exceptions, consultez la documentation des classes descendantes, telles que HttpWebRequest et FileWebRequest.

La classe WebRequest contient de nouveaux membres lorsqu'elle est utilisée dans un projet Bibliothèque de classes portable. Pour plus d'informations, consultez Differences API dans la bibliothèque de classes portable.

Remarque
Utilisez la méthode Create pour initialiser de nouvelles instances de WebRequest. N'utilisez pas le constructeur WebRequest.

Remarque
Si l'application qui crée l'objet WebRequest s'exécute avec les informations d'identification d'un utilisateur normal, l'application n'est pas capable d'accéder aux certificats installés dans le magasin de l'ordinateur local à moins que l'autorisation d'effectuer cette opération n'ait été explicitement donnée à l'utilisateur.

Lorsque vous héritez de WebRequest, vous devez substituer les membres suivants : Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream, BeginGetRequestStream, EndGetRequestStream, GetResponse, BeginGetResponse et EndGetResponse. En outre, vous devez fournir une implémentation de l'interface IWebRequestCreate qui définit la méthode Create utilisée lors de l'appel à la méthode Create. Vous devez inscrire la classe qui implémente l'interface IWebRequestCreate, à l'aide de la méthode RegisterPrefix ou du fichier de configuration.

L'exemple suivant illustre la création d'une instance de WebRequest et retourne la réponse.

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

.NET Framework

.NET Framework Client Profile

• WebPermission  

  Pour accéder à l'URI demandé ou à tout URI vers lequel la demande est redirigée. Énumération associée : Connect.

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources