WebRequest Classe

Définition

public ref class WebRequest abstract

public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable

public abstract class WebRequest

public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

[System.Serializable]
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

type WebRequest = class

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

[<System.Serializable>]
type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

Héritage

Object

WebRequest

Héritage

Object

MarshalByRefObject

WebRequest

Dérivé

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Attributs

SerializableAttribute

Implémente

ISerializable

Exemples

L’exemple suivant montre comment créer une WebRequest instance et retourner 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 ();
        }
    }
}

Imports System.IO
Imports System.Net
Imports System.Text

Namespace Examples.System.Net
    Public Class WebRequestGetExample

        Public Shared Sub Main()
            ' Create a request for the URL. 		
            Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
            ' If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials
            ' Get the response.
            Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
            ' Display the status.
            Console.WriteLine(response.StatusDescription)
            ' Get the stream containing content returned by the server.
            Dim dataStream As Stream = response.GetResponseStream()
            ' Open the stream using a StreamReader for easy access.
            Dim reader As New StreamReader(dataStream)
            ' Read the content.
            Dim responseFromServer As String = reader.ReadToEnd()
            ' Display the content.
            Console.WriteLine(responseFromServer)
            ' Cleanup the streams and the response.
            reader.Close()
            dataStream.Close()
            response.Close()
        End Sub
    End Class
End Namespace

Remarques

WebRequest est la abstract classe de base pour . Modèle de demande/réponse de NET pour accéder aux données à partir d’Internet. Une application qui utilise le modèle de requête/réponse peut demander des données à partir d’Internet de manière indépendante du protocole, dans laquelle l’application fonctionne avec des instances de la WebRequest classe tandis que les classes descendantes spécifiques au protocole effectuent les détails de la requête.

Les demandes sont envoyées d’une application à un URI particulier, par exemple une page web sur un serveur. L’URI détermine la classe descendante appropriée à créer à partir d’une liste de WebRequest descendants inscrits pour l’application. WebRequest Les descendants sont généralement inscrits pour gérer un protocole spécifique, tel que HTTP ou FTP, mais peuvent être inscrits pour gérer une requête auprès d’un serveur ou d’un chemin d’accès spécifique sur un serveur.

La WebRequest classe lève une WebException erreur lorsque des erreurs se produisent lors de l’accès à une ressource Internet. La Status propriété est l’une des WebExceptionStatus valeurs qui indique la source de l’erreur. Quand Status c’est WebExceptionStatus.ProtocolErrorle cas, la Response propriété contient la WebResponse propriété reçue de la ressource Internet.

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

Notes pour les responsables de l’implémentation

Lorsque vous héritez de WebRequest, vous devez remplacer les membres suivants : Method, HeadersRequestUri, , ContentLength, ContentType, , , PreAuthenticateCredentials, GetRequestStream()BeginGetRequestStream(AsyncCallback, Object), , , EndGetRequestStream(IAsyncResult), , GetResponse()BeginGetResponse(AsyncCallback, Object)et .EndGetResponse(IAsyncResult) En outre, vous devez fournir une implémentation de l’interface IWebRequestCreate , qui définit la Create(Uri) méthode utilisée lorsque vous appelez Create(Uri). Vous devez inscrire la classe qui implémente l’interface IWebRequestCreate , à l’aide de la RegisterPrefix(String, IWebRequestCreate) méthode ou du fichier de configuration.

Voir aussi

• HttpWebRequest
• Demande de données
• Programmation de protocoles enfichables