HttpWebRequest Třída

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Requests.dll

Zdroj:

HttpWebRequest.cs

Poskytuje implementaci WebRequest třídy specifickou pro HTTP.

public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

type HttpWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable

Dědičnost

Object

MarshalByRefObject

WebRequest

HttpWebRequest

Implementuje

ISerializable

Příklady

Následující příklad kódu vytvoří HttpWebRequest pro identifikátor URI http://www.contoso.com/.

HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

Dim myReq As HttpWebRequest = _
    WebRequest.Create("http://www.contoso.com/")

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Třída HttpWebRequest poskytuje podporu vlastností a metod definovaných v WebRequest a pro další vlastnosti a metody, které uživateli umožňují pracovat přímo se servery pomocí protokolu HTTP.

Nepoužívejte HttpWebRequest konstruktor. WebRequest.Create Pomocí metody inicializovat nové HttpWebRequest objekty. Pokud je schéma identifikátoru URI (Uniform Resource Identifier) http:// nebo https://, Create vrátí HttpWebRequest objekt.

Metoda GetResponse vytvoří synchronní požadavek na prostředek zadaný ve RequestUri vlastnosti a vrátí HttpWebResponse , který obsahuje objekt odpovědi. Data odpovědi lze přijímat pomocí datového proudu vráceného GetResponseStream. Pokud je objekt odpovědi nebo stream odpovědi zavřený, zbývající data se propadnou. Zbývající data se vyprázdní a soket se znovu použije pro následné požadavky při zavření objektu odpovědi nebo datového proudu, pokud jsou splněny následující podmínky: jedná se o požadavek na zachování nebo kanál, je potřeba přijímat pouze malé množství dat nebo zbývající data se přijímají v malém časovém intervalu. Pokud se nezmíní žádné z uvedených podmínek nebo dojde k překročení doby vyprázdnění, soket se zavře. V případě připojení s udržováním nebo kanálem důrazně doporučujeme, aby aplikace přečetla datové proudy, dokud EOF nečte. Tím se zajistí opětovné použití soketu pro následné požadavky, což vede k lepšímu výkonu a menšímu využití prostředků.

Pokud chcete odeslat data do prostředku, GetRequestStream vrátí Stream metoda objekt, který se má použít k odesílání dat. EndGetRequestStream Metody BeginGetRequestStream poskytují asynchronní přístup k datovému proudu pro odesílání.

Pro ověřování klientů s klientem HttpWebRequestmusí být klientský certifikát nainstalován v úložišti certifikátů aktuálního uživatele.

Třída HttpWebRequest vyvolá WebException chybu, ke které dojde při přístupu k prostředku. Vlastnost WebException.Status obsahuje WebExceptionStatus hodnotu, která označuje zdroj chyby. Pokud WebException.Status je WebExceptionStatus.ProtocolErrortato vlastnost, Response obsahuje HttpWebResponse přijatou z prostředku.

HttpWebRequest zveřejňuje běžné hodnoty hlaviček HTTP odesílané do internetového prostředku jako vlastnosti, nastavené metodami nebo nastavené systémem; Následující tabulka obsahuje úplný seznam. Další hlavičky ve Headers vlastnosti můžete nastavit jako páry název/hodnota. Všimněte si, že servery a mezipaměti se můžou během požadavku měnit nebo přidávat hlavičky.

Následující tabulka uvádí hlavičky HTTP, které jsou nastaveny buď podle vlastností, nebo metod nebo systému.

Záhlaví	Nastavit podle
Accept	Nastavte vlastnost Accept .
Connection	Nastavte vlastnost Connection , KeepAlive vlastnost.
Content-Length	Nastavte vlastnost ContentLength .
Content-Type	Nastavte vlastnost ContentType .
Expect	Nastavte vlastnost Expect .
Date	Nastavte podle systému aktuální datum.
Host	Nastavte systém na aktuální informace o hostiteli.
If-Modified-Since	Nastavte vlastnost IfModifiedSince .
Range	Nastavte metodou AddRange .
Referer	Nastavte vlastnost Referer .
Transfer-Encoding	Nastavte vlastnost TransferEncoding ( SendChunked vlastnost musí být true).
User-Agent	Nastavte vlastnost UserAgent .

Poznámka

HttpWebRequest se automaticky zaregistruje. Před RegisterPrefixSystem.Net.HttpWebRequest použitím identifikátorů URI začínajících http:// nebo https://.

Konfigurační soubor místního počítače nebo aplikace může určovat, že se použije výchozí proxy server. Proxy Pokud je tato vlastnost zadaná, přepíší nastavení proxy z Proxy vlastnosti konfigurační soubor místního počítače nebo aplikace a HttpWebRequest instance použije zadaná nastavení proxy serveru. Pokud není v konfiguračním souboru zadán žádný proxy server a Proxy vlastnost není zadána, HttpWebRequest třída používá nastavení proxy zděděné z možností internetu v místním počítači. Pokud v možnostech internetu nejsou k dispozici žádná nastavení proxy serveru, požadavek se odešle přímo na server.

Poznámka

Rozhraní ukládá relace SSL do mezipaměti při jejich vytváření a pokud je to možné, pokusí se znovu použít relaci uloženou v mezipaměti pro nový požadavek. Při pokusu o opakované použití relace SSL používá framework první prvek ClientCertificates (pokud existuje) nebo se pokusí znovu použít anonymní relace, pokud ClientCertificates je prázdný.

Poznámka

Z bezpečnostních důvodů jsou soubory cookie ve výchozím nastavení zakázané. Pokud chcete používat soubory cookie, použijte CookieContainer tuto vlastnost k povolení souborů cookie.

Pro aplikace, které používají protokol TLS/SSL prostřednictvím rozhraní API, jako jsou HttpClient, HttpWebRequest, FTPClient, SmtpClient a SsStream, blokuje .NET ve výchozím nastavení nezabezpečené šifrovací algoritmy a algoritmy hash pro připojení. Možná budete muset toto chování vyloučit, abyste zachovali interoperabilitu se stávajícími službami SSL3 nebo službami TLS w/ RC4. Po upgradu na rozhraní .NET Framework 4.6 se nelze připojit k serveru pomocí rozhraní ServicePointManager nebo SslStream API . V případě potřeby vysvětluje, jak upravit kód tak, aby toto chování zakázal.

Konstruktory

Name	Description
HttpWebRequest(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci HttpWebRequest třídy ze zadaných SerializationInfo instancí třídy a StreamingContext třídy. Tento konstruktor je zastaralý.

Vlastnosti

Name	Description
Accept	Získá nebo nastaví hodnotu hlavičky Accept HTTP.
Address	Získá identifikátor URI (Uniform Resource Identifier) internetového prostředku, který ve skutečnosti reaguje na požadavek.
AllowAutoRedirect	Získá nebo nastaví hodnotu, která určuje, jestli má požadavek postupovat podle odpovědí přesměrování.
AllowReadStreamBuffering	Získá nebo nastaví hodnotu, která určuje, zda se má ukládat do vyrovnávací paměti přijaté z internetového prostředku.
AllowWriteStreamBuffering	Získá nebo nastaví hodnotu, která určuje, zda se mají ukládat data odesílaná do internetového prostředku.
AuthenticationLevel	Získá nebo nastaví hodnoty označující úroveň ověřování a zosobnění použité pro tento požadavek. (Zděděno od WebRequest)
AutomaticDecompression	Získá nebo nastaví typ dekomprese, který se používá.
CachePolicy	Získá nebo nastaví zásady mezipaměti pro tento požadavek. (Zděděno od WebRequest)
ClientCertificates	Získá nebo nastaví kolekci certifikátů zabezpečení, které jsou přidružené k tomuto požadavku.
Connection	Získá nebo nastaví hodnotu hlavičky Connection HTTP.
ConnectionGroupName	Získá nebo nastaví název skupiny připojení pro požadavek.
ContentLength	Získá nebo nastaví hlavičku Content-length HTTP.
ContentType	Získá nebo nastaví hodnotu hlavičky Content-type HTTP.
ContinueDelegate	Získá nebo nastaví delegovací metodu volanou při přijetí odpovědi HTTP 100-continue z internetového prostředku.
ContinueTimeout	Získá nebo nastaví časový limit v milisekundách čekání na 100-Continue ze serveru.
CookieContainer	Získá nebo nastaví soubory cookie přidružené k žádosti.
Credentials	Získá nebo nastaví ověřovací informace pro požadavek.
Date	Získá nebo nastaví hodnotu hlavičky Date HTTP pro použití v požadavku HTTP.
DefaultCachePolicy	Získá nebo nastaví výchozí zásady mezipaměti pro tento požadavek.
DefaultMaximumErrorResponseLength	Získá nebo nastaví výchozí maximální délku chybové odpovědi HTTP.
DefaultMaximumResponseHeadersLength	Získá nebo nastaví výchozí pro MaximumResponseHeadersLength vlastnost.
Expect	Získá nebo nastaví hodnotu hlavičky Expect HTTP.
HaveResponse	Získá hodnotu, která označuje, zda byla odpověď přijata z internetového prostředku.
Headers	Určuje kolekci dvojic name/value, které tvoří hlavičky HTTP.
Host	Získá nebo nastaví hodnotu hlavičky hostitele použít v požadavku HTTP nezávisle na identifikátoru URI požadavku.
IfModifiedSince	Získá nebo nastaví hodnotu hlavičky If-Modified-Since HTTP.
ImpersonationLevel	Získá nebo nastaví úroveň zosobnění pro aktuální požadavek. (Zděděno od WebRequest)
KeepAlive	Získá nebo nastaví hodnotu, která určuje, zda se má vytvořit trvalé připojení k internetovému prostředku.
MaximumAutomaticRedirections	Získá nebo nastaví maximální počet přesměrování, které požadavek následuje.
MaximumResponseHeadersLength	Získá nebo nastaví maximální povolenou délku hlaviček odpovědi.
MediaType	Získá nebo nastaví typ média požadavku.
Method	Získá nebo nastaví metodu pro požadavek.
Pipelined	Získá nebo nastaví hodnotu, která určuje, zda se má požadavek kanálovat do internetového prostředku.
PreAuthenticate	Získá nebo nastaví hodnotu, která určuje, zda se má odeslat autorizační hlavička s požadavkem.
ProtocolVersion	Získá nebo nastaví verzi PROTOKOLU HTTP, která se má použít pro požadavek.
Proxy	Získá nebo nastaví informace o proxy serveru pro požadavek.
ReadWriteTimeout	Získá nebo nastaví časový limit v milisekundách při zápisu do nebo čtení z datového proudu.
Referer	Získá nebo nastaví hodnotu hlavičky Referer HTTP.
RequestUri	Získá původní identifikátor URI (Uniform Resource Identifier) požadavku.
SendChunked	Získá nebo nastaví hodnotu, která určuje, zda se mají odesílat data v segmentech do internetového prostředku.
ServerCertificateValidationCallback	Získá nebo nastaví funkci zpětného volání k ověření certifikátu serveru.
ServicePoint	Získá bod služby, který se má použít pro požadavek.
SupportsCookieContainer	Získá hodnotu, která určuje, zda požadavek poskytuje podporu pro .CookieContainer
Timeout	Získá nebo nastaví hodnotu časového limitu v milisekundách pro metody GetResponse() a GetRequestStream() metody.
TransferEncoding	Získá nebo nastaví hodnotu hlavičky Transfer-encoding HTTP.
UnsafeAuthenticatedConnectionSharing	Získá nebo nastaví hodnotu, která určuje, zda povolit vysokorychlostní sdílení připojení ověřené protokolem NTLM.
UseDefaultCredentials	Získá nebo nastaví Boolean hodnotu, která určuje, zda jsou výchozí přihlašovací údaje odesílány s požadavky.
UserAgent	Získá nebo nastaví hodnotu hlavičky User-agent HTTP.

Metody

Name	Description
Abort()	Zruší požadavek na internetový prostředek.
AddRange(Int32, Int32)	Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.
AddRange(Int32)	Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.
AddRange(Int64, Int64)	Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.
AddRange(Int64)	Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.
AddRange(String, Int32, Int32)	Přidá hlavičku rozsahu do požadavku na zadaný rozsah.
AddRange(String, Int32)	Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.
AddRange(String, Int64, Int64)	Přidá hlavičku rozsahu do požadavku na zadaný rozsah.
AddRange(String, Int64)	Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.
BeginGetRequestStream(AsyncCallback, Object)	Zahájí asynchronní požadavek na Stream objekt, který se má použít k zápisu dat.
BeginGetResponse(AsyncCallback, Object)	Zahájí asynchronní požadavek na internetový prostředek.
EndGetRequestStream(IAsyncResult, TransportContext)	Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat a výstupů TransportContext přidružených ke streamu.
EndGetRequestStream(IAsyncResult)	Ukončí asynchronní požadavek na objekt, Stream který se má použít k zápisu dat.
EndGetResponse(IAsyncResult)	Ukončí asynchronní požadavek na internetový prostředek.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo data požadovaná k serializaci cílového objektu.
GetRequestStream()	Stream Získá objekt, který se má použít k zápisu dat požadavku.
GetRequestStream(TransportContext)	Stream Získá objekt, který se použije k zápisu dat požadavku a výstupy TransportContext přidružené ke streamu.
GetRequestStreamAsync()	Při přepsání v potomk třídy vrátí Stream pro zápis dat do internetového prostředku jako asynchronní operace. (Zděděno od WebRequest)
GetResponse()	Vrátí odpověď z internetového prostředku.
GetResponseAsync()	Při přepsání v potomk třídy vrátí odpověď na internetový požadavek jako asynchronní operace. (Zděděno od WebRequest)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo data potřebná k serializaci cílového objektu.

Viz také

• DefaultProxy – element (nastavení sítě)
• Změny ověřování NTLM pro HTTPWebRequest ve verzi 3.5 SP1