Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DataServiceContext.BeginGetReadStream Method (Object, DataServiceRequestArgs, AsyncCallback, Object)

Asynchronously gets the binary data stream that belongs to the specified entity, by using the specified message headers.

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
public IAsyncResult BeginGetReadStream(
	Object entity,
	DataServiceRequestArgs args,
	AsyncCallback callback,
	Object state
)

Parameters

entity
Type: System.Object
The entity that has a the binary data stream to retrieve.
args
Type: System.Data.Services.Client.DataServiceRequestArgs
Instance of the DataServiceRequestArgs class that contains settings for the HTTP request message.
callback
Type: System.AsyncCallback
Delegate to invoke when results are available for client consumption.
state
Type: System.Object
User-defined state object passed to the callback.

Return Value

Type: System.IAsyncResult
An IAsyncResult object that is used to track the status of the asynchronous operation.
ExceptionCondition
ArgumentNullException

Any of the parameters supplied to the method is null.

ArgumentException

The entity is not tracked by this DataServiceContext.

-or-

The entity is in the Added state.

-or-

The entity is not a Media Link Entry and does not have a related binary data stream.

The GetReadStream method asynchronously requests the binary data stream that belongs to the requested entity.

In the AtomPub protocol, the entity is a Media Link Entry and the binary data stream is the associated Media Resource.

No validation is performed on the headers that are set in args. Therefore, do not change an HTTP header in a way that changes the meaning of the request.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.