System.Net.WebRequest.GetRequestStream Method

When overridden in a descendant class, returns a System.IO.Stream for writing data to the Internet resource.

Syntax

public virtual System.IO.Stream GetRequestStream ()

Returns

A System.IO.Stream for writing data to the Internet resource.

Exceptions

TypeReason
NotSupportedExceptionThis method is not overridden in the derived class.

Remarks

The WebRequest.GetRequestStream method initiates a request to send data to the Internet resource and returns a System.IO.Stream instance for sending data to the Internet resource.

The WebRequest.GetRequestStream method provides synchronous access to the System.IO.Stream. For asynchronous access, use the WebRequest.BeginGetRequestStream(AsyncCallback, object) and WebRequest.EndGetRequestStream(IAsyncResult) methods.

Note:

The System.Net.WebRequest class is an abstract class. The actual behavior of System.Net.WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create(Uri) method. For more information about default values and exceptions, see the documentation for the descendant classes, such as System.Net.HttpWebRequest and System.Net.FileWebRequest.

Requirements

Namespace: System.Net
Assembly: System (in System.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0