WebRequest::GetRequestStream Method ()
When overridden in a descendant class, returns a Stream for writing data to the Internet resource.
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| NotImplementedException | Any attempt is made to access the method, when the method is not overridden in a descendant class. |
The GetRequestStream method initiates a request to send data to the Internet resource and returns a Stream instance for sending data to the Internet resource.
The GetRequestStream method provides synchronous access to the Stream. For asynchronous access, use the BeginGetRequestStream and EndGetRequestStream methods.
Note |
|---|
The WebRequest class is an abstract class. The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest::Create method. For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest. |
The following example uses the GetRequestStream method to obtain a stream and then writes data that stream.
// Set the 'ContentType' property of the WebRequest. myWebRequest->ContentType = "application/x-www-form-urlencoded"; // Set the 'ContentLength' property of the WebRequest. myWebRequest->ContentLength = byteArray->Length; Stream^ newStream = myWebRequest->GetRequestStream(); newStream->Write( byteArray, 0, byteArray->Length ); // Close the Stream object. newStream->Close(); // Assign the response object of 'WebRequest' to a 'WebResponse' variable. WebResponse^ myWebResponse = myWebRequest->GetResponse();
Available since 1.1
