FileWebRequest.GetRequestStreamAsync Method

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Source:

FileWebRequest.cs

Returns a stream for writing data to the file system resource as an asynchronous operation.

public:
 override System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetRequestStreamAsync();

public override System.Threading.Tasks.Task<System.IO.Stream> GetRequestStreamAsync ();

override this.GetRequestStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>

Public Overrides Function GetRequestStreamAsync () As Task(Of Stream)

Returns

Task<Stream>

The task object representing the asynchronous operation.

Exceptions

InvalidOperationException

The stream is being used by a previous call to BeginGetRequestStream(AsyncCallback, Object).

-or-

The stream already received a response previous to your request.

ProtocolViolationException

The Method property is GET or HEAD.

WebException

The FileWebRequest was aborted.

Remarks

Note

In the case of asynchronous requests, the client application is responsible for implementing its own time-out mechanism.

This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as ArgumentException, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by GetRequestStream().