DataServiceContext.BeginGetReadStream Methode

Definition

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Ruft asynchron binäre Eigenschaftendaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenheadern als Datenstrom ab.

public:
 IAsyncResult ^ BeginGetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginGetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args, AsyncCallback callback, object state);

member this.BeginGetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs * AsyncCallback * obj -> IAsyncResult

Public Function BeginGetReadStream (entity As Object, args As DataServiceRequestArgs, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

entity

Object

Die Entität, die über die abzurufende binäre Eigenschaft verfügt.

args

DataServiceRequestArgs

Instanz der Klasse DataServiceRequestArgs, die Einstellungen für die HTTP-Anforderungsnachricht enthält.

callback

AsyncCallback

Delegat, der aufgerufen werden soll, wenn Ergebnisse für die Verwendung durch den Client verfügbar sind.

state

Object

Benutzerdefiniertes Statusobjekt, das an den Rückruf übergeben wird.

Gibt zurück

IAsyncResult

Ein IAsyncResult-Objekt, das verwendet wird, um den Status des asynchronen Vorgangs nachzuverfolgen.

Ausnahmen

ArgumentNullException

Einer der Parameter, die für die Methode angegeben wurden, ist null.

ArgumentException

entity wird nicht von DataServiceContext nachverfolgt.

- oder -

Die entity befindet sich im Zustand Added.

- oder -

Die entity ist kein Medienlinkeintrag und verfügt über keine binäre Eigenschaft.

Hinweise

Die GetReadStream -Methode fordert asynchron einen Datenstrom an, der die binäre Eigenschaft des angeforderten entityenthält.

Im AtomPub-Protokoll ist der entity ein Media Link-Eintrag, und die binäre Eigenschaft ist die zugeordnete Medienressource.

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.