WebRequest Třída

Definice

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

Dědičnost

Object

WebRequest

Dědičnost

Object

MarshalByRefObject

WebRequest

Odvozené

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Atributy

SerializableAttribute

Implementuje

ISerializable

Příklady

Následující příklad ukazuje, jak vytvořit instanci WebRequest a vrátit odpověď.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Text;
int 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 = dynamic_cast<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 = gcnew 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();
}

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

Poznámky

WebRequest je základní třída abstract pro . Model požadavků a odpovědí net pro přístup k datům z internetu Aplikace, která používá model požadavků a odpovědí, může vyžadovat data z internetu způsobem, který je nezávislý na protokolu, ve kterém aplikace pracuje s instancemi třídy WebRequest, zatímco potomkové třídy specifické pro protokol provádějí podrobnosti požadavku.

Požadavky se odesílají z aplikace na konkrétní identifikátor URI, například na webové stránce na serveru. Identifikátor URI určuje správnou potomkovou třídu, která se má vytvořit ze seznamu WebRequest potomků registrovaných pro aplikaci. WebRequest potomky se obvykle registrují ke zpracování konkrétního protokolu, jako je HTTP nebo FTP, ale je možné je zaregistrovat ke zpracování požadavku na konkrétní server nebo cestu na serveru.

Třída WebRequest vyvolá WebException, když dojde k chybám při přístupu k internetovému prostředku. Vlastnost Status je jednou z hodnot WebExceptionStatus, která označuje zdroj chyby. Při Status je WebExceptionStatus.ProtocolError, vlastnost Response obsahuje WebResponse přijaté z internetového prostředku.

Protože WebRequest třída je abstract třída, skutečné chování WebRequest instancí za běhu je určeno potomkem třídy vrácenou Create metodou. Další informace o výchozích hodnotách a výjimkách naleznete v dokumentaci pro potomky třídy, jako jsou HttpWebRequest a FileWebRequest.

Poznámky pro implementátory

Při dědění z WebRequestje nutné přepsat následující členy: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)a EndGetResponse(IAsyncResult). Kromě toho musíte poskytnout implementaci IWebRequestCreate rozhraní, která definuje Create(Uri) metodu použitou při volání Create(Uri). Pomocí metody RegisterPrefix(String, IWebRequestCreate) nebo konfiguračního souboru je nutné zaregistrovat třídu, která implementuje rozhraní IWebRequestCreate.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• HttpWebRequest
• vyžádání datových
• programovací protokoly