WebRequest Класс

Определение

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

Наследование

Object

WebRequest

Наследование

Object

MarshalByRefObject

WebRequest

Производный

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Атрибуты

SerializableAttribute

Реализации

ISerializable

Примеры

В следующем примере показано, как создать экземпляр WebRequest и вернуть ответ.

#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

Комментарии

WebRequest — базовый класс abstract. Модель запроса и ответа NET для доступа к данным из Интернета. Приложение, использующее модель запроса и ответа, может запрашивать данные из Интернета в не зависящем от протокола способе, в котором приложение работает с экземплярами класса WebRequest в то время как классы-потомки, относящиеся к протоколу, выполняют сведения о запросе.

Запросы отправляются из приложения в определенный универсальный код ресурса (URI), например веб-страницу на сервере. Универсальный код ресурса (URI) определяет соответствующий класс-потомок для создания из списка WebRequest потомков, зарегистрированных для приложения. WebRequest потомки обычно регистрируются для обработки определенного протокола, например HTTP или FTP, но могут быть зарегистрированы для обработки запроса к конкретному серверу или пути на сервере.

Класс WebRequest создает WebException при возникновении ошибок при доступе к интернет-ресурсу. Свойство Status является одним из значений WebExceptionStatus, указывающих источник ошибки. Если StatusWebExceptionStatus.ProtocolError, свойство Response содержит WebResponse, полученные из ресурса Интернета.

Так как класс WebRequest является классом abstract, фактическое поведение экземпляров WebRequest во время выполнения определяется классом-потомком, возвращаемым методом Create. Дополнительные сведения о значениях и исключениях по умолчанию см. в документации по классам-потомкам, таким как HttpWebRequest и FileWebRequest.

Примечания для тех, кто реализует этот метод

При наследовании от WebRequestнеобходимо переопределить следующие члены: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)и EndGetResponse(IAsyncResult). Кроме того, необходимо предоставить реализацию интерфейса IWebRequestCreate, который определяет метод Create(Uri), используемый при вызове Create(Uri). Необходимо зарегистрировать класс, реализующий интерфейс IWebRequestCreate, с помощью метода RegisterPrefix(String, IWebRequestCreate) или файла конфигурации.

См. также раздел

• HttpWebRequest
• запрос данных
• подключаемые протоколы программирования