DataServiceContext.BeginGetReadStream Methode

Definition

Ruft asynchron binäre Eigenschaftsdaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenkopfzeilen 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 mit der abzurufenden binären Eigenschaft.

args
DataServiceRequestArgs

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

callback
AsyncCallback

Delegieren, um aufzurufen, wenn Ergebnisse für die Clientnutzung verfügbar sind.

state
Object

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

Gibt zurück

Ein IAsyncResult Objekt, das zum Nachverfolgen des Status des asynchronen Vorgangs verwendet wird.

Ausnahmen

Jeder der Parameter, die der Methode bereitgestellt werden, ist null.

Dies entity wird nicht nachverfolgt DataServiceContext.

-oder-

Das entity ist im Added Zustand.

-oder-

Dies entity ist kein Medienlinkeintrag und verfügt nicht über eine binäre Eigenschaft.

Hinweise

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

Im AtomPub-Protokoll ist dies entity ein Media Link Entry und die binäre Eigenschaft ist die zugeordnete Medienressource.

Für die Kopfzeilen, in argsdenen festgelegt ist, wird keine Überprüfung ausgeführt. Ändern Sie daher keinen HTTP-Header so, dass die Bedeutung der Anforderung geändert wird.

Gilt für: