Export (0) Print
Expand All

HttpWebRequest.EndGetRequestStream Method (IAsyncResult)

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

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

abstract EndGetRequestStream : 
        asyncResult:IAsyncResult -> Stream  
override EndGetRequestStream : 
        asyncResult:IAsyncResult -> Stream

Parameters

asyncResult
Type: System.IAsyncResult

The pending request for a stream.

Return Value

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

ExceptionCondition
ArgumentNullException

asyncResult is a 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.

WebException

Abort was previously called.

-or-

An error occurred while processing the request.

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.

NoteNote

You must set the value of the ContentLength property before writing data to the stream.

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.

NoteNote

This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework.

The following code example uses the EndGetRequestStream method to end an asynchronous request for a stream instance.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft