DataServiceContext.GetReadStream-Methode (Object, String)
Ruft den binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).
Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Function GetReadStream ( _
entity As Object, _
acceptContentType As String _
) As DataServiceStreamResponse
'Usage
Dim instance As DataServiceContext
Dim entity As Object
Dim acceptContentType As String
Dim returnValue As DataServiceStreamResponse
returnValue = instance.GetReadStream(entity, _
acceptContentType)
public DataServiceStreamResponse GetReadStream(
Object entity,
string acceptContentType
)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
String^ acceptContentType
)
member GetReadStream :
entity:Object *
acceptContentType:string -> DataServiceStreamResponse
public function GetReadStream(
entity : Object,
acceptContentType : String
) : DataServiceStreamResponse
Parameter
- entity
Typ: System.Object
Die Entität, die über den abzurufenden binären Datenstrom verfügt.
- acceptContentType
Typ: System.String
Der Content-Type des binären Datenstroms, der vom Datendienst angefordert wurde (im Accept-Header).
Rückgabewert
Typ: System.Data.Services.Client.DataServiceStreamResponse
Eine Instanz von DataServiceStreamResponse, die die Antwort darstellt.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | entity ist nullein NULL-Verweis (Nothing in Visual Basic). - oder - acceptContentType ist nullein NULL-Verweis (Nothing in Visual Basic). |
ArgumentException | entity wird nicht von DataServiceContext nachverfolgt. - oder - Die entity befindet sich im Zustand Added. - oder - entity ist kein Medien-Link-Eintrag und verfügt nicht über einen zugehörigen Strom. |
Hinweise
Der acceptContentType-Parameter sollte ein gültiger Content-Type-Wert für den Accept-HTTP-Header sein.
Die GetReadStream-Methode fordert synchron den zugehörigen binären Datenstrom für entity an.
Im AtomPub-Protokoll ist entity ein Medienlinkeintrag, und der binäre Strom ist die dazugehörigen Medien-Ressource.
Keine Validierung wird auf den Headern ausgeführt, die in acceptContentType festgelegt werden. Ändern Sie diesen HTTP-Header nicht in einer Weise, die die Bedeutung von der Anforderung ändert.