BeginGetRequestStream Method

WebRequest.BeginGetRequestStream Method (AsyncCallback, Object)

 

When overridden in a descendant class, provides an asynchronous version of the GetRequestStream method.

Namespace:   System.Net
Assembly:  System (in System.dll)

[<HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)>]
abstract BeginGetRequestStream : 
        callback:AsyncCallback *
        state:Object -> IAsyncResult
[<HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)>]
override BeginGetRequestStream : 
        callback:AsyncCallback *
        state:Object -> IAsyncResult

Parameters

callback
Type: System.AsyncCallback

The AsyncCallback delegate.

state
Type: System.Object

An object containing state information for this asynchronous request.

Return Value

Type: System.IAsyncResult

An IAsyncResult that references the asynchronous request.

Exception Condition
NotImplementedException

Any attempt is made to access the method, when the method is not overridden in a descendant class.

The BeginGetRequestStream method starts an asynchronous request for a stream used to send data to an Internet resource. The callback method that implements the AsyncCallback delegate uses the EndGetRequestStream method to return the request stream.

System_CAPS_noteNote

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 BeginGetRequestStream to asynchronously obtain the request stream.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft