HttpWebRequest::GetRequestStream Method (TransportContext%)
Assembly: System (in System.dll)
The GetRequestStream method is called more than once.
The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented.
The Method property is GET or HEAD.
Abort was previously called.
The time-out period for the request expired.
An error occurred while processing the request.
The GetRequestStream method returns a stream to use to send data for the HttpWebRequest and outputs the TransportContext associated with the stream. After the Stream object has been returned, you can send data with the HttpWebRequest by using the Stream::Write method.
Some applications that use integrated Windows authentication with extended protection may need to be able to query the transport layer used by HttpWebRequest in order to retrieve the channel binding token (CBT) from the underlying TLS channel. The GetRequestStream method provides access to this information for HTTP methods which have a request body (POST and PUT requests). This is only needed if the application is implementing its own authentication and needs access to the CBT.
If an application needs to set the value of the ContentLength property, then this must be done before retrieving the stream.
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.
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.
Windows 7, Windows Vista SP1 or later, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.