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.
| Exception | Condition |
|---|---|
| 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.
.gif?cs-save-lang=1&cs-lang=fsharp "Note") Note |
|---|
You must set the value of the ContentLength property before writing data to the stream. |
.gif?cs-save-lang=1&cs-lang=fsharp "Caution note") Caution |
|---|
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. |
| Note |
|---|
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing. |
The following code example uses the EndGetRequestStream method to end an asynchronous request for a stream instance.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
