WebRequest Třída

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

WebRequest.cs

Vytvoří požadavek na identifikátor URI (Uniform Resource Identifier). Toto je abstract třída.

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

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

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

Dědičnost

Object

MarshalByRefObject

WebRequest

Odvozené

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Implementuje

ISerializable

Příklady

Následující příklad ukazuje, jak vytvořit WebRequest instanci 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

Důležité

WebRequest Nepoužívejte nebo odvozené třídy pro nový vývoj. Místo toho použijte System.Net.Http.HttpClient třídu .

WebRequestabstract je základní třída pro . Model požadavků a odpovědí na platformu NET pro přístup k datům z internetu. Aplikace, která používá model požadavků a odpovědí, může požadovat data z internetu způsobem nezávislým na protokolu, kdy aplikace pracuje s instancemi WebRequest třídy, zatímco potomky 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 webovou stránku na serveru. Identifikátor URI určuje správnou třídu potomků, která se má vytvořit ze seznamu potomků registrovaných WebRequest pro aplikaci. WebRequest Potomci jsou obvykle registrováni pro zpracování konkrétního protokolu, jako je HTTP nebo FTP, ale mohou být registrováni pro zpracování požadavku na konkrétní server nebo cestu na serveru.

Třída WebRequest vyvolá chybu , když dojde k chybám WebException při přístupu k internetovému prostředku. Vlastnost Status je jednou z WebExceptionStatus hodnot, které označují zdroj chyby. Pokud Status je WebExceptionStatus.ProtocolErrorhodnota , Response vlastnost obsahuje WebResponse přijatý prostředek z internetu.

Vzhledem k tomu, že WebRequest třída je abstract třída, je skutečné chování WebRequest instancí za běhu určeno následnou třídou vrácenou metodou Create . Další informace o výchozích hodnotách a výjimkách najdete v dokumentaci pro odvozené třídy, například HttpWebRequest a FileWebRequest.

Poznámka

K inicializaci nových WebRequest instancí použijte metodu Create . Nepoužívejte WebRequest konstruktor.

Poznámka

Pokud aplikace, která vytváří objekt WebRequest, běží s přihlašovacími údaji normálního uživatele, aplikace nebude mít přístup k certifikátům nainstalovaným v úložišti místního počítače, pokud uživatel k tomu explicitně neudělí oprávnění.

Poznámky pro implementátory

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

Konstruktory

WebRequest()	Zastaralé. Inicializuje novou instanci WebRequest třídy .
WebRequest(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci WebRequest třídy ze zadaných SerializationInfo instancí tříd a StreamingContext .

Vlastnosti

AuthenticationLevel	Získá nebo nastaví hodnoty označující úroveň ověřování a zosobnění použité pro tento požadavek.
CachePolicy	Získá nebo nastaví zásady mezipaměti pro tento požadavek.
ConnectionGroupName	Při přepsání v odvozené třídě získá nebo nastaví název skupiny připojení pro požadavek.
ContentLength	Při přepsání v odvozené třídě získá nebo nastaví délku obsahu odesílaných dat požadavku.
ContentType	Při přepsání v odvozené třídě získá nebo nastaví typ obsahu odesílaných dat požadavku.
Credentials	Při přepsání v odvozené třídě získá nebo nastaví přihlašovací údaje sítě používané k ověření požadavku s internetovým prostředkem.
DefaultCachePolicy	Získá nebo nastaví výchozí zásady mezipaměti pro tento požadavek.
DefaultWebProxy	Získá nebo nastaví globální proxy server HTTP.
Headers	Při přepsání v odvozené třídě získá nebo nastaví kolekci dvojic název/hodnota hlavičky přidružené k požadavku.
ImpersonationLevel	Získá nebo nastaví úroveň zosobnění pro aktuální požadavek.
Method	Při přepsání v odvozené třídě získá nebo nastaví metodu protokolu pro použití v tomto požadavku.
PreAuthenticate	Při přepsání v odvozené třídě určuje, zda se má požadavek předběžně ověřit.
Proxy	Při přepsání v odvozené třídě získá nebo nastaví síťový proxy server pro přístup k tomuto internetovému prostředku.
RequestUri	Při přepsání v odvozené třídě získá identifikátor URI internetového prostředku přidruženého k požadavku.
Timeout	Získá nebo nastaví dobu v milisekundách před vypršením časového limitu požadavku.
UseDefaultCredentials	Při přepsání v odvozené třídě získá nebo nastaví Boolean hodnotu, která určuje, zda DefaultCredentials jsou odeslány s požadavky.

Metody

Abort()	Přeruší požadavek.
BeginGetRequestStream(AsyncCallback, Object)	Při přepsání v odvozené třídě poskytuje asynchronní verzi GetRequestStream() metody .
BeginGetResponse(AsyncCallback, Object)	Při přepsání v odvozené třídě začne asynchronní požadavek na internetový prostředek.
Create(String)	Zastaralé. Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru URI.
Create(Uri)	Zastaralé. Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru URI.
CreateDefault(Uri)	Zastaralé. Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru URI.
CreateHttp(String)	Zastaralé. Inicializuje novou HttpWebRequest instanci pro zadaný řetězec identifikátoru URI.
CreateHttp(Uri)	Zastaralé. Inicializuje novou HttpWebRequest instanci pro zadaný identifikátor URI.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	Při přepsání v odvozené třídě vrátí hodnotu pro Stream zápis dat do internetového prostředku.
EndGetResponse(IAsyncResult)	Při přepsání v odvozené třídě vrátí hodnotu WebResponse.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo objekt daty potřebnými k serializaci cílového objektu.
GetRequestStream()	Při přepsání v odvozené třídě vrátí hodnotu pro Stream zápis dat do internetového prostředku.
GetRequestStreamAsync()	Při přepsání v odvozené třídě vrátí hodnotu Stream pro zápis dat do internetového prostředku jako asynchronní operaci.
GetResponse()	Při přepsání v odvozené třídě, vrátí odpověď na požadavek internetu.
GetResponseAsync()	Při přepsání v odvozené třídě vrátí odpověď na požadavek internetu jako asynchronní operaci.
GetSystemWebProxy()	Vrátí proxy server nakonfigurovaný s nastavením možností Internetu aktuálně zosobněného uživatele.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
RegisterPrefix(String, IWebRequestCreate)	Zaregistruje potomka WebRequest pro zadaný identifikátor URI.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Zastaralé. Při přepsání v odvozené třídě, naplní SerializationInfo instanci dat potřebnými k serializaci WebRequest.

Viz také

• HttpWebRequest
• Žádosti o data
• Programování připojitelných protokolů