• Article

HttpWebRequest.EndGetRequestStream Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Ends an asynchronous request for a Stream object to use to write data.

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

Syntax

'Declaration
Public Overrides Function EndGetRequestStream ( _
    asyncResult As IAsyncResult _
) As Stream

public override Stream EndGetRequestStream(
    IAsyncResult asyncResult
)

Parameters

Return Value

Type: System.IO.Stream
A Stream to use to write request data.

Exceptions

Exception Condition
ArgumentNullException

asyncResult is nulla null reference (Nothing in Visual Basic).
IOException

The request did not complete, and no stream is available.
ArgumentException

asyncResult was not returned by the current instance from a call to BeginGetRequestStream.
InvalidOperationException

This method was called previously using asyncResult.
NotImplementedException

This method is not implemented.
WebException

Abort was previously called.

-or-

An error occurred while processing the request.

Remarks

The EndGetRequestStream method completes an asynchronous request for a stream that was started by the BeginGetRequestStream method. After the Stream object has been returned, you can send data with the HttpWebRequest by using the Stream.Write method.

Caution noteCaution:

You must call the Stream.Close method to close the stream and release the connection for reuse. Failure to close the stream causes your application to run out of connections.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.