WebRequest Třída

Reference

Definice

Obor názvů:: System.Net

Sestavení:: System.Net.Requests.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

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 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 ani jeho 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í pro přístup k datům z internetu Aplikace, která používá model požadavku nebo odpovědi, může požadovat data z internetu způsobem, který je nezávislý na protokolu, ve kterém aplikace pracuje s instancemi WebRequest třídy, zatímco potomkové třídy specifické pro protokol provádějí podrobnosti požadavku.

Požadavky se odesílají z aplikace do určitého identifikátoru URI, například webové stránky na serveru. Identifikátor URI určuje správnou potomkovou třídu, 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, například HTTP nebo FTP, ale je možné ho zaregistrovat ke zpracování požadavku na konkrétní server nebo cestu na serveru.

Třída WebRequest vyvolá WebException při přístupu k internetovému prostředku chybu. Vlastnost Status je jednou z WebExceptionStatus hodnot, které označují zdroj chyby. Když Status je WebExceptionStatus.ProtocolError, Response vlastnost obsahuje WebResponse přijatý z internetového prostředku.

Vzhledem k tomu, ž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 metodou Create . Další informace o výchozích hodnotách a výjimkách najdete v dokumentaci pro třídy potomků, například HttpWebRequest a FileWebRequest.

Poznámka

Použijte metodu Create k inicializaci nových WebRequest instancí. WebRequest Nepoužívejte konstruktor.

Poznámka

Pokud aplikace, která vytvoří objekt WebRequest, běží s přihlašovacími údaji normálního uživatele, aplikace nebude moct získat přístup k certifikátům nainstalovaným v úložišti místního počítače, pokud ho uživatel výslovně neudělil.

Poznámky pro implementátory

Při dědění z WebRequest, musíte přepsat následující členy: Method, ContentLength Credentials Headers ContentType RequestUri PreAuthenticate, GetRequestStream(), EndGetResponse(IAsyncResult)BeginGetRequestStream(AsyncCallback, Object)EndGetRequestStream(IAsyncResult)GetResponse()BeginGetResponse(AsyncCallback, Object), a . 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í a StreamingContext tříd.

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ásadu mezipaměti pro tento požadavek.
ConnectionGroupName	Při přepsání v potomkovací třídě získá nebo nastaví název skupiny připojení pro požadavek.
ContentLength	Při přepsání v potomkovací třídě získá nebo nastaví délku obsahu odesílaných dat požadavku.
ContentType	Při přepsání v potomkovací třídě získá nebo nastaví typ obsahu odesílaných dat požadavku.
CreatorInstance	Zastaralé. Při přepsání v potomku třídy získá objekt továrny odvozený z IWebRequestCreate třídy použité k vytvoření WebRequest instance pro vytvoření požadavku na zadaný identifikátor URI.
Credentials	Při přepsání v potomkovací třídě získá nebo nastaví síťové přihlašovací údaje použité k ověřování požadavku pomocí internetového prostředku.
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 potomkovací třídě získá nebo nastaví kolekci párů názvů a hodnot hlaviček přidružených k požadavku.
ImpersonationLevel	Získá nebo nastaví úroveň zosobnění pro aktuální požadavek.
Method	Při přepsání v potomkovací třídě získá nebo nastaví metodu protokolu, která se použije v tomto požadavku.
PreAuthenticate	Při přepsání v potomkové třídě označuje, zda se má požadavek před ověřením ověřit.
Proxy	Při přepsání v potomkovací 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 potomkové 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 potomkovací třídě získá nebo nastaví Boolean hodnotu, která řídí, zda DefaultCredentials jsou odesílány s požadavky.

Metody

Abort()	Přeruší žádost.
BeginGetRequestStream(AsyncCallback, Object)	Při přepsání v potomkové třídě poskytuje asynchronní verzi GetRequestStream() metody.
BeginGetResponse(AsyncCallback, Object)	Při přepsání v potomkové 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 serveru používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	Při přepsání v potomkové třídě vrátí hodnotu Stream pro zápis dat do internetového prostředku.
EndGetResponse(IAsyncResult)	Při přepsání v potomkové třídě vrátí WebResponsehodnotu .
Equals(Object)	Určí, zda se zadaný objekt rovná 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 aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo data potřebná k serializaci cílového objektu.
GetRequestStream()	Při přepsání v potomkové třídě vrátí hodnotu Stream pro zápis dat do internetového prostředku.
GetRequestStreamAsync()	Při přepsání v potomkové třídě vrátí hodnotu Stream pro zápis dat do internetového prostředku jako asynchronní operace.
GetResponse()	Při přepsání v potomkové třídě vrátí odpověď na internetový požadavek.
GetResponseAsync()	Při přepsání v potomkové třídě vrátí odpověď na internetový požadavek jako asynchronní operace.
GetSystemWebProxy()	Vrátí proxy server nakonfigurovaný s nastavením Aplikace Internet Explorer aktuálně zosobněného uživatele.
GetType()	Type Získá aktuální instanci. (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ří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět. (Zděděno od MarshalByRefObject)
RegisterPortableWebRequestCreator(IWebRequestCreate)	Zastaralé. Zaregistrujte IWebRequestCreate objekt.
RegisterPrefix(String, IWebRequestCreate)	Zaregistruje WebRequest potomka 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 potomkové třídě naplní SerializationInfo instanci dat potřebnými k serializaci WebRequest.

Platí pro