WebRequest Klas

Definitie

public ref class WebRequest abstract

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

public abstract class WebRequest

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

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

type WebRequest = class

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

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

Overname

Object

WebRequest

Overname

Object

MarshalByRefObject

WebRequest

Afgeleid

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Kenmerken

SerializableAttribute

Implementeringen

ISerializable

Voorbeelden

In het volgende voorbeeld ziet u hoe u een WebRequest exemplaar maakt en het antwoord retourneert.

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

Opmerkingen

WebRequest is de basisklasse abstract voor het aanvraag-/antwoordmodel van .NET voor toegang tot gegevens van internet. Een toepassing die gebruikmaakt van het aanvraag-/antwoordmodel kan gegevens van internet op een protocolagnostische manier aanvragen, waarbij de toepassing werkt met exemplaren van de WebRequest klasse, terwijl protocolspecifieke onderliggende klassen de details van de aanvraag uitvoeren.

Aanvragen worden verzonden van een toepassing naar een bepaalde URI, zoals een webpagina op een server. De URI bepaalt de juiste afstammelingsklasse die moet worden gemaakt op basis van WebRequest een lijst met afstammelingen die zijn geregistreerd voor de toepassing. WebRequest afstammelingen worden doorgaans geregistreerd voor het afhandelen van een specifiek protocol, zoals HTTP of FTP, maar kunnen worden geregistreerd om een aanvraag naar een specifieke server of een specifiek pad op een server af te handelen.

De WebRequest klasse genereert een WebException wanneer er fouten optreden tijdens het openen van een internetresource. De Status eigenschap is een van de WebExceptionStatus waarden die de bron van de fout aangeeft. Wanneer Status is WebExceptionStatus.ProtocolError, bevat de Response eigenschap de WebResponse ontvangen van de internetresource.

Omdat de WebRequest klasse een abstract klasse is, wordt het werkelijke gedrag van WebRequest exemplaren tijdens runtime bepaald door de onderliggende klasse die wordt geretourneerd door Create de methode. Zie de documentatie voor de onderliggende klassen, zoals HttpWebRequest en FileWebRequestvoor meer informatie over standaardwaarden en uitzonderingen.

Notities voor uitvoerders

Wanneer u overdrat, WebRequestmoet u de volgende leden overschrijven: Method, , RequestUri, ContentTypeHeadersCredentialsPreAuthenticateContentLength, , GetResponse()BeginGetRequestStream(AsyncCallback, Object)EndGetRequestStream(IAsyncResult)GetRequestStream(), , en . BeginGetResponse(AsyncCallback, Object)EndGetResponse(IAsyncResult) Daarnaast moet u een implementatie van de IWebRequestCreate interface opgeven, waarmee de Create(Uri) methode wordt gedefinieerd die wordt gebruikt wanneer u aanroept Create(Uri). U moet de klasse registreren die de IWebRequestCreate interface implementeert met behulp van de RegisterPrefix(String, IWebRequestCreate) methode of het configuratiebestand.

Zie ook

• HttpWebRequest
• Gegevens aanvragen
• Pluggable-protocollen programmeren