DataServiceContext::GetReadStream Method (Object^, String^)
Gets binary property data for the specified entity as a data stream, with the specified Accept message header.
Assembly: System.Data.Services.Client (in System.Data.Services.Client.dll)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
String^ acceptContentType
)
Parameters
- entity
-
Type:
System::Object^
The entity that has the binary property to retrieve.
- acceptContentType
-
Type:
System::String^
The content type of the data requested from the data service, specified in the Accept header.
Return Value
Type: System.Data.Services.Client::DataServiceStreamResponse^An instance of DataServiceStreamResponse that represents the response.
| Exception | Condition |
|---|---|
| ArgumentNullException | entity is null. -or- acceptContentType 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 binary property. |
The acceptContentType parameter should be a valid value for the Accept HTTP header.
The GetReadStream method synchronously requests a data stream that contains the binary property of the requested entity.
In the AtomPub protocol, the entity is a Media Link Entry and the binary property is the associated Media Resource.
No validation is performed on the headers that are set in acceptContentType. Therefore, do not change this HTTP header in a way that changes the meaning of the request.
Available since 3.5