WebRequest Klasse

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Sendet eine Anforderung an einen Uniform Resource Identifier (URI). Dies ist eine abstract-Klasse.

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

Vererbung: Object
WebRequest

Vererbung: Object

MarshalByRefObject
WebRequest

Abgeleitet: System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Attribute: SerializableAttribute

Implementiert: ISerializable

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine WebRequest Instanz erstellen und die Antwort zurückgeben.

#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

Hinweise

Wichtig

Verwenden WebRequest Sie keine abgeleiteten Klassen für neue Entwicklung. Verwenden Sie stattdessen die System.Net.Http.HttpClient Klasse.

WebRequest ist die abstract Basisklasse für . DAS Anforderungs-/Antwortmodell für den Zugriff auf Daten aus dem Internet. Eine Anwendung, die das Anforderungs-/Antwortmodell verwendet, kann Daten aus dem Internet auf protokollagnostische Weise anfordern, in der die Anwendung mit Instanzen der Klasse arbeitet, während protokollspezifische absteigende Klassen die Details der WebRequest Anforderung ausführen.

Anforderungen werden von einer Anwendung an einen bestimmten URI gesendet, z. B. eine Webseite auf einem Server. Der URI bestimmt die richtige absteigende Klasse, um aus einer Liste der WebRequest für die Anwendung registrierten Untergeordneten zu erstellen. WebRequest Die Untergeordneten werden in der Regel registriert, um ein bestimmtes Protokoll wie HTTP oder FTP zu behandeln, kann jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu behandeln.

Die WebRequest Klasse löst beim Zugriff auf eine Internetressource einen WebException Fehler aus. Die Status Eigenschaft ist eine der Werte, die WebExceptionStatus die Quelle des Fehlers angibt. Wenn Status es WebExceptionStatus.ProtocolErrorsich um die Eigenschaft handelt, enthält die Response Eigenschaft den WebResponse Empfangenen aus der Internetressource.

Da die WebRequest Klasse eine abstract Klasse ist, wird das tatsächliche Verhalten von WebRequest Instanzen zur Laufzeit durch die absteigende Klasse bestimmt, die von Create der Methode zurückgegeben wird. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die absteigenden Klassen, z HttpWebRequest . B. und FileWebRequest.

Hinweis

Verwenden Sie die Create Methode, um neue WebRequest Instanzen zu initialisieren. Verwenden Sie nicht die WebRequest Konstruktor.

Hinweis

Wenn die Anwendung, die das WebRequest-Objekt erstellt, mit den Anmeldeinformationen eines normalen Benutzers ausgeführt wird, kann die Anwendung nicht auf Zertifikate zugreifen, die im lokalen Computerspeicher installiert sind, es sei denn, die Berechtigung wurde dem Benutzer explizit erteilt.

Hinweise für Ausführende

Wenn Sie von WebRequesterben, müssen Sie die folgenden Mitglieder außer Kraft setzen: Method, Headers ContentLength EndGetRequestStream(IAsyncResult)GetResponse()BeginGetResponse(AsyncCallback, Object)RequestUri Credentials EndGetResponse(IAsyncResult)ContentType PreAuthenticate GetRequestStream()BeginGetRequestStream(AsyncCallback, Object)und . Darüber hinaus müssen Sie eine Implementierung der IWebRequestCreate Schnittstelle bereitstellen, die die Create(Uri) beim Aufrufen Create(Uri)verwendete Methode definiert. Sie müssen die Klasse registrieren, die die IWebRequestCreate Schnittstelle implementiert, mit der Methode oder der RegisterPrefix(String, IWebRequestCreate) Konfigurationsdatei.

Konstruktoren

WebRequest()	Veraltet. Initialisiert eine neue Instanz der WebRequest-Klasse.
WebRequest(SerializationInfo, StreamingContext)	Veraltet. Initialisiert eine neue Instanz der WebRequest-Klasse aus den angegebenen Instanzen der SerializationInfo-Klasse und der StreamingContext-Klasse.

Eigenschaften

AuthenticationLevel	Ruft Werte ab, die die für diese Anforderung verwendete Ebene von Authentifizierung und Identitätswechsel angeben, oder legt diese fest.
CachePolicy	Ruft die Cacherichtlinie für diese Anforderung ab oder legt diese fest.
ConnectionGroupName	Ruft beim Überschreiben in einer Nachfolgerklasse den Namen der Verbindungsgruppe für die Anforderung ab oder legt diesen fest.
ContentLength	Ruft beim Überschreiben in einer Nachfolgerklasse die Inhaltslänge der zu sendenden Anforderungsdaten ab oder legt diese fest.
ContentType	Ruft beim Überschreiben in einer Nachfolgerklasse den Inhaltstyp der zu sendenden Anforderungsdaten ab oder legt diese fest.
CreatorInstance	Veraltet. Ruft beim Überschreiben in einer Nachfolgerklasse das von der IWebRequestCreate-Klasse abgeleitete Factoryobjekt ab. Mit dieser Klasse wird die WebRequest erstellt, die instanziiert wird, um die Anforderung an den angegebenen URI zu stellen.
Credentials	Ruft beim Überschreiben in einer Nachfolgerklasse die Netzwerkanmeldeinformationen, die für die Authentifizierung der Anforderung der Internetressource verwendet werden, ab oder legt diese fest.
DefaultCachePolicy	Ruft die Standardcacherichtlinie für diese Anforderung ab oder legt diese fest.
DefaultWebProxy	Ruft den globalen HTTP-Proxy ab oder legt diesen fest.
Headers	Ruft beim Überschreiben in einer Nachfolgerklasse eine Auflistung von Name-Wert-Paaren für Header ab, die mit der Anforderung verknüpft sind, oder legt diese fest.
ImpersonationLevel	Ruft die Ebene des Identitätswechsels für die aktuelle Anforderung ab oder legt diese fest.
Method	Ruft beim Überschreiben in einer Nachfolgerklasse die in dieser Anforderung zu verwendende Protokollmethode ab oder legt diese fest.
PreAuthenticate	Gibt beim Überschreiben in einer Nachfolgerklasse an, ob die Anforderung zuvor authentifiziert werden muss.
Proxy	Ruft beim Überschreiben in einer Nachfolgerklasse den beim Zugriff auf diese Internetressource verwendeten Netzwerkproxy ab oder legt diesen fest.
RequestUri	Ruft beim Überschreiben in einer Nachfolgerklasse den mit der Anforderung verknüpften URI der Internetressource ab.
Timeout	Ruft die Zeitspanne in Millisekunden bis zum Überschreiten des Zeitlimits der Anforderung ab.
UseDefaultCredentials	Ruft beim Überschreiben in einer Nachfolgerklasse einen Boolean-Wert ab, der steuert, ob mit Anforderungen DefaultCredentials gesendet werden, oder legt einen solchen Wert fest.

Methoden

Abort()	Bricht die Anforderung ab.
BeginGetRequestStream(AsyncCallback, Object)	Stellt beim Überschreiben in einer Nachfolgerklasse eine asynchrone Version der GetRequestStream()-Methode bereit.
BeginGetResponse(AsyncCallback, Object)	Startet beim Überschreiben in einer Nachfolgerklasse eine asynchrone Anforderung einer Internetressource.
Create(String)	Veraltet. Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.
Create(Uri)	Veraltet. Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.
CreateDefault(Uri)	Veraltet. Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.
CreateHttp(String)	Veraltet. Initialisiert eine neue HttpWebRequest-Instanz für die angegebene URI-Zeichenfolge.
CreateHttp(Uri)	Veraltet. Initialisiert eine neue HttpWebRequest-Instanz für den angegebenen URI.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	Gibt beim Überschreiben in einer Nachfolgerklasse einen Stream zum Schreiben von Daten in die Internetressource zurück.
EndGetResponse(IAsyncResult)	Gibt beim Überschreiben in einer Nachfolgerklasse eine WebResponse zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.
GetRequestStream()	Gibt beim Überschreiben in einer Nachfolgerklasse einen Stream zum Schreiben von Daten in die Internetressource zurück.
GetRequestStreamAsync()	Gibt nach dem Überschreiben in einer abgeleiteten Klasse einen Stream zurück, womit Daten in einem asynchronen Vorgang in die Internetressource geschrieben werden können.
GetResponse()	Gibt beim Überschreiben in einer Nachfolgerklasse eine Antwort auf eine Internetanforderung zurück.
GetResponseAsync()	Gibt beim Überschreiben in einer Nachfolgerklasse in einem asynchronen Vorgang eine Antwort auf eine Internetanforderung zurück.
GetSystemWebProxy()	Gibt einen Proxy zurück, der mit den Internet Explorer-Einstellungen des Benutzers konfiguriert ist, dessen Identität gerade verwendet wird.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
RegisterPortableWebRequestCreator(IWebRequestCreate)	Veraltet. Registrieren eines IWebRequestCreate-Objekts.
RegisterPrefix(String, IWebRequestCreate)	Registriert einen WebRequest-Nachfolger für den angegebenen URI.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Veraltet.

Füllt beim Überschreiben in einer Nachfolgerklasse eine SerializationInfo-Instanz mit den Daten auf, die zum Serialisieren der WebRequest erforderlich sind.

Gilt für