Freigeben über


DataServiceContext.BeginGetReadStream-Methode (Object, DataServiceRequestArgs, AsyncCallback, Object)

Ruft asynchron den binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Syntax

'Declaration
Public Function BeginGetReadStream ( _
    entity As Object, _
    args As DataServiceRequestArgs, _
    callback As AsyncCallback, _
    state As Object _
) As IAsyncResult
'Usage
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginGetReadStream(entity, _
    args, callback, state)
public IAsyncResult BeginGetReadStream(
    Object entity,
    DataServiceRequestArgs args,
    AsyncCallback callback,
    Object state
)
public:
IAsyncResult^ BeginGetReadStream(
    Object^ entity, 
    DataServiceRequestArgs^ args, 
    AsyncCallback^ callback, 
    Object^ state
)
member BeginGetReadStream : 
        entity:Object * 
        args:DataServiceRequestArgs * 
        callback:AsyncCallback * 
        state:Object -> IAsyncResult 
public function BeginGetReadStream(
    entity : Object, 
    args : DataServiceRequestArgs, 
    callback : AsyncCallback, 
    state : Object
) : IAsyncResult

Parameter

  • entity
    Typ: System.Object
    Die Entität, die über den abzurufenden binären Datenstrom verfügt.
  • callback
    Typ: System.AsyncCallback
    Aufruf-Delegierter, wenn Ergebnisse für Clientverbrauch verfügbar sind.
  • state
    Typ: System.Object
    Benutzerdefiniertes Statusobjekt, das an den Rückruf übergeben wird.

Rückgabewert

Typ: System.IAsyncResult
Ein IAsyncResult-Objekt, das verwendet wird, um den Status vom asynchronen Vorgang nachzuverfolgen.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Einer der zur Methode angegebenen Parameter 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 Datenstrom.

Hinweise

Die Methode GetReadStream fordert ssynchron den binären Datenstrom an der zur angeforderten entity gehört.

Im AtomPub-Protokoll ist entity ein Medienlinkeintrag, und der binäre Datenstrom ist die dazugehörigen Medien-Ressource.

Keine Validierung wird auf den Headern ausgeführt, die in args festgelegt werden. Ändern Sie keinen HTTP-Header in einer Weise, die die Bedeutung von der Anforderung ändert.

Siehe auch

Verweis

DataServiceContext Klasse

BeginGetReadStream-Überladung

System.Data.Services.Client-Namespace