HttpWebRequest.EndGetRequestStream-Methode

Artikel
08/20/2007

Beendet eine asynchrone Anforderung eines Stream-Objekts, das zum Schreiben von Daten verwendet werden soll.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overrides Function EndGetRequestStream ( _
    asyncResult As IAsyncResult _
) As Stream
'Usage
Dim instance As HttpWebRequest
Dim asyncResult As IAsyncResult
Dim returnValue As Stream

returnValue = instance.EndGetRequestStream(asyncResult)

public override Stream EndGetRequestStream (
    IAsyncResult asyncResult
)

public:
virtual Stream^ EndGetRequestStream (
    IAsyncResult^ asyncResult
) override

public Stream EndGetRequestStream (
    IAsyncResult asyncResult
)

public override function EndGetRequestStream (
    asyncResult : IAsyncResult
) : Stream

Parameter

asyncResult
Die ausstehende Anforderung für einen Stream.

Rückgabewert

Ein Stream, der zum Schreiben von Anforderungsdaten verwendet werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	asyncResult ist NULL (Nothing in Visual Basic).
IOException	Die Anforderung wurde nicht abgeschlossen, und es ist kein Stream verfügbar.
ArgumentException	asyncResult wurde nicht durch die aktuelle Instanz von einem Anruf von BeginGetRequestStream zurückgegeben.
InvalidOperationException	Diese Methode wurde zuvor unter Verwendung von asyncResult aufgerufen.
WebException	Abort wurde bereits zuvor aufgerufen. - oder - Fehler bei der Verarbeitung der Anforderung.

Hinweise

Die EndGetRequestStream-Methode schließt eine asynchrone Anforderung eines Streams ab, die durch die BeginGetRequestStream-Methode gestartet wurde. Nachdem das Stream-Objekt zurückgegeben wurde, können Sie mit der HttpWebRequest unter Verwendung der Stream.Write-Methode Daten senden.

Hinweis

Bevor Sie Daten in den Stream schreiben, müssen Sie den Wert der ContentLength-Eigenschaft festlegen.

Warnung

Sie müssen die Stream.Close-Methode aufrufen, um den Stream zu schließen und die Verbindung für die erneute Verwendung freizugeben. Wenn der Stream nicht geschlossen wird, führt dies dazu, dass der Anwendung nicht ausreichend Verbindungen zur Verfügung stehen.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung.

Beispiel

Im folgenden Codebeispiel wird die EndGetRequestStream-Methode zum Beenden einer asynchronen Anforderung einer Streaminstanz verwendet.

Imports System
Imports System.Net
Imports System.IO
Imports System.Text
Imports System.Threading
Imports Microsoft.VisualBasic

Class HttpWebRequestBeginGetRequest
    Public Shared allDone As New ManualResetEvent(False)

    Shared Sub Main()


        ' Create a new HttpWebRequest object.
      '  Dim request As HttpWebRequest = CType(WebRequest.Create("https://www.contoso.com/example.aspx"), _
       '         HttpWebRequest)
Dim request As HttpWebRequest = CType(WebRequest.Create("https://localhost/test/PostAccepter.aspx"), _
            HttpWebRequest)
        ' Set the ContentType property.
        request.ContentType = "application/x-www-form-urlencoded"
        '  Set the Method property to 'POST' to post data to the URI.
        request.Method = "POST"
        ' Start the asynchronous operation.     
        Dim result As IAsyncResult = _
            CType(request.BeginGetRequestStream(AddressOf ReadCallback, request), IAsyncResult)
        ' Keep the main thread from continuing while the asynchronous
        ' operation completes. A real world application
        ' could do something useful such as updating its user interface. 
        allDone.WaitOne()
        '  Get the response.
        Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
        Dim streamResponse As Stream = response.GetResponseStream()
        Dim streamRead As New StreamReader(streamResponse)
        Dim responseString As String = streamRead.ReadToEnd()
        
        Console.WriteLine(responseString)
        
        ' Close Stream object.
        streamResponse.Close()
        streamRead.Close()

        ' Release the HttpWebResponse.
        response.Close()
            
    End Sub ' Main

    Private Shared Sub ReadCallback(ByVal asynchronousResult As IAsyncResult)
        Dim request As HttpWebRequest = CType(asynchronousResult.AsyncState, HttpWebRequest)
        ' End the operation.
        Dim postStream As Stream = request.EndGetRequestStream(asynchronousResult)
        Console.WriteLine("Please enter the input data to be posted:")
        Dim postData As [String] = Console.ReadLine()
        
        '  Convert the string into byte array.
        Dim byteArray As Byte() = Encoding.UTF8.GetBytes(postData)
        ' Write to the stream.
        postStream.Write(byteArray, 0, postData.Length)
        postStream.Close()
        allDone.Set()
    End Sub ' ReadCallback

End Class ' HttpWebRequest_BeginGetRequest

using System;
using System.Net;
using System.IO;
using System.Text;
using System.Threading;

class HttpWebRequestBeginGetRequest
{
    public static ManualResetEvent allDone = new ManualResetEvent(false);
    public static void Main()
    {
        

            // Create a new HttpWebRequest object.
            HttpWebRequest request=(HttpWebRequest) WebRequest.Create("https://www.contoso.com/example.aspx");    
    
            // Set the ContentType property. 
            request.ContentType="application/x-www-form-urlencoded";
            // Set the Method property to 'POST' to post data to the URI.
            request.Method = "POST";
            // Start the asynchronous operation.    
            request.BeginGetRequestStream(new AsyncCallback(ReadCallback), request);    
            
            // Keep the main thread from continuing while the asynchronous
            // operation completes. A real world application
            // could do something useful such as updating its user interface. 
            allDone.WaitOne();

            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream streamResponse = response.GetResponseStream();
            StreamReader streamRead = new StreamReader(streamResponse);
            string responseString = streamRead.ReadToEnd();
            Console.WriteLine(responseString);
            // Close the stream object.
            streamResponse.Close();
            streamRead.Close();
    
            // Release the HttpWebResponse.
            response.Close();
        }
    
    private static void ReadCallback(IAsyncResult asynchronousResult)
    {    
            HttpWebRequest request = (HttpWebRequest)asynchronousResult.AsyncState;
            // End the operation.
            Stream postStream = request.EndGetRequestStream(asynchronousResult);
            Console.WriteLine("Please enter the input data to be posted:");
            string postData = Console.ReadLine ();
            
            // Convert the string into a byte array.
            byte[] byteArray = Encoding.UTF8.GetBytes(postData);
            // Write to the request stream.
            postStream.Write(byteArray, 0, postData.Length);
            postStream.Close ();
            allDone.Set();    
    }

}

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
using namespace System::Text;
using namespace System::Threading;
ref class HttpWebRequestBeginGetRequest
{
public:
   static ManualResetEvent^ allDone = gcnew ManualResetEvent( false );
   static void Main()
   {
      
      // Create a new HttpWebRequest object.
      HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "https://www.contoso.com/example.aspx" ));
      
      // Set the ContentType property.
      request->ContentType = "application/x-www-form-urlencoded";
      
      // Set the Method property to 'POST' to post data to the Uri.
      request->Method = "POST";
      
      // Start the asynchronous operation.    
      AsyncCallback^ del = gcnew AsyncCallback( ReadCallback );
      request->BeginGetRequestStream( del, request );
      
      // Keep the main thread from continuing while the asynchronous
      // operation completes. A real world application
      // could do something useful such as updating its user interface. 
      allDone->WaitOne();
      HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
      Stream^ streamResponse = response->GetResponseStream();
      StreamReader^ streamRead = gcnew StreamReader( streamResponse );
      String^ responseString = streamRead->ReadToEnd();
      Console::WriteLine( responseString );
      
      // Close Stream object.
      streamResponse->Close();
      streamRead->Close();
      
      // Release the HttpWebResponse.
      response->Close();
   }


private:
   static void ReadCallback( IAsyncResult^ asynchronousResult )
   {
      HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(asynchronousResult->AsyncState);
      
      // End the operation.
      Stream^ postStream = request->EndGetRequestStream( asynchronousResult );
      Console::WriteLine( "Please enter the input data to be posted:" );
      String^ postData = Console::ReadLine();
      
      // Convert the string into Byte array.
      array<Byte>^ByteArray = Encoding::UTF8->GetBytes( postData );
      
      // Write to the request stream.
      postStream->Write( ByteArray, 0, postData->Length );
      postStream->Close();
      allDone->Set();
   }

};

void main()
{
   HttpWebRequestBeginGetRequest::Main();
}

import System.*;
import System.Net.*;
import System.IO.*;
import System.Text.*;
import System.Threading.*;

class HttpWebRequestBeginGetRequest
{
    public static ManualResetEvent allDone = new ManualResetEvent(false);

    public static void main(String[] args)
    {
        // Create a new HttpWebRequest object.
        HttpWebRequest request = (HttpWebRequest)(WebRequest.Create(
            "https://www.contoso.com/example.aspx"));
        // Set the ContentType property. 
        request.set_ContentType("application/x-www-form-urlencoded");
        // Set the Method property to 'POST' to post data to the URI.
        request.set_Method("POST");
        // Start the asynchronous operation.    
        request.BeginGetRequestStream(new AsyncCallback(ReadCallback), request);
        // Keep the main thread from continuing while the asynchronous
        // operation completes. A real world application
        // could do something useful such as updating its user interface. 
        allDone.WaitOne();

        // Get the response.
        HttpWebResponse response = (HttpWebResponse)(request.GetResponse());
        Stream streamResponse = response.GetResponseStream();
        StreamReader streamRead = new StreamReader(streamResponse);
        String responseString = streamRead.ReadToEnd();
        Console.WriteLine(responseString);

        // Close the stream object.
        streamResponse.Close();
        streamRead.Close();
        // Release the HttpWebResponse.
        response.Close();
    } //main

    private static void ReadCallback(IAsyncResult asynchronousResult)
    {
        HttpWebRequest request = (HttpWebRequest)
            (asynchronousResult.get_AsyncState());
        // End the operation.
        Stream postStream = request.EndGetRequestStream(asynchronousResult);
        Console.WriteLine("Please enter the input data to be posted:");
        String postData = Console.ReadLine();
        // Convert the string into a byte array.
        ubyte byteArray[] = Encoding.get_UTF8().GetBytes(postData);
        // Write to the request stream.
        postStream.Write(byteArray, 0, postData.get_Length());
        postStream.Close();
        allDone.Set();
    } //ReadCallback
} //HttpWebRequestBeginGetRequest

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Freigeben über

HttpWebRequest.EndGetRequestStream-Methode

Syntax

Parameter

Rückgabewert

Ausnahmen

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen