WebRequest Klasse

Definition

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

Das folgende Beispiel zeigt, 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

WebRequest ist die abstract Basisklasse für . Das Anforderungs-/Antwortmodell von NET für den Zugriff auf Daten aus dem Internet. Eine Anwendung, die das Anforderungs-/Antwortmodell verwendet, kann Daten aus dem Internet protokollagnostisch anfordern, in der die Anwendung mit Instanzen der WebRequest Klasse arbeitet, während protokollspezifische untergeordnete Klassen die Details der 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, die aus einer Liste von WebRequest untergeordneten Elementen erstellt werden soll, die für die Anwendung registriert sind. WebRequest Untergeordneten werden in der Regel registriert, um ein bestimmtes Protokoll wie HTTP oder FTP zu verarbeiten, kann jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.

Die WebRequest Klasse löst eine WebException aus, wenn Beim Zugriff auf eine Internetressource Fehler auftreten. Die Status-Eigenschaft ist einer der WebExceptionStatus Werte, die die Quelle des Fehlers angibt. Wenn StatusWebExceptionStatus.ProtocolErrorist, enthält die Response-Eigenschaft die von der Internetressource empfangenen WebResponse.

Da es sich bei der WebRequest-Klasse um eine abstract Klasse handelt, wird das tatsächliche Verhalten WebRequest Instanzen zur Laufzeit durch die von Create Methode zurückgegebene absteigende Klasse bestimmt. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die untergeordneten Klassen, z. B. HttpWebRequest und FileWebRequest.

Hinweise für Ausführende

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

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• HttpWebRequest
• Anfordern von Daten
• Austauschbare Protokolle