WebRequest Klass

Definition

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

Arv

Object

WebRequest

Arv

Object

MarshalByRefObject

WebRequest

Härledda

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Attribut

SerializableAttribute

Implementeringar

ISerializable

Exempel

I följande exempel visas hur du skapar en WebRequest instans och returnerar svaret.

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

Kommentarer

WebRequest är basklassen abstract för .NET begäran/svar-modell för åtkomst till data från Internet. Ett program som använder begäran/svar-modellen kan begära data från Internet på ett protokollagnostiskt sätt, där programmet fungerar med instanser av WebRequest klassen medan protokollspecifika underordnade klasser utför informationen om begäran.

Begäranden skickas från ett program till en viss URI, till exempel en webbsida på en server. URI:n avgör vilken underordnad klass som ska skapas från en lista över WebRequest underordnade som registrerats för programmet. WebRequest underordnade är vanligtvis registrerade för att hantera ett specifikt protokoll, till exempel HTTP eller FTP, men kan registreras för att hantera en begäran till en specifik server eller sökväg på en server.

Klassen WebRequest genererar ett WebException när fel inträffar vid åtkomst till en Internetresurs. Egenskapen Status är ett av de WebExceptionStatus värden som anger källan till felet. När Status är WebExceptionStatus.ProtocolErrorResponse innehåller egenskapen den WebResponse mottagna från Internetresursen.

WebRequest Eftersom klassen är en abstract klass bestäms det faktiska beteendet för WebRequest instanser vid körning av den underordnade klassen som returneras av Create metoden. Mer information om standardvärden och undantag finns i dokumentationen för underordnade klasser, till exempel HttpWebRequest och FileWebRequest.

Anteckningar till implementerare

När du ärver från WebRequestmåste du åsidosätta följande medlemmar: Method, RequestUri, Headers, ContentLength, ContentType, , CredentialsPreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), , GetResponse()och BeginGetResponse(AsyncCallback, Object)EndGetResponse(IAsyncResult). Dessutom måste du ange en implementering av IWebRequestCreate gränssnittet, som definierar den Create(Uri) metod som används när du anropar Create(Uri). Du måste registrera klassen som implementerar IWebRequestCreate gränssnittet med hjälp av RegisterPrefix(String, IWebRequestCreate) metoden eller konfigurationsfilen.

Se även

• HttpWebRequest
• Begära data
• Programmeringsprotokoll som kan anslutas