Condividi tramite


DataServiceContext.BeginGetReadStream Metodo

Definizione

Ottiene in modo asincrono i dati della proprietà binaria per l'entità specificata come flusso di dati insieme alle intestazioni di messaggio specificate.

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

Parametri

entity
Object

Entità che dispone della proprietà binaria da recuperare.

args
DataServiceRequestArgs

Istanza della classe DataServiceRequestArgs contenente impostazioni per il messaggio della richiesta HTTP.

callback
AsyncCallback

Delegato da richiamare se sono disponibili risultati per l'utilizzo client.

state
Object

Oggetto stato definito dall'utente passato al callback.

Restituisce

Oggetto IAsyncResult utilizzato per rilevare lo stato dell'operazione asincrona.

Eccezioni

Uno dei parametri forniti al metodo è null.

entity non viene rilevato da DataServiceContext.

-oppure-

L'oggetto entity si trova in uno stato Added.

-oppure-

entity non è una voce di collegamento multimediale e non dispone di una proprietà binaria.

Commenti

Il GetReadStream metodo richiede in modo asincrono un flusso di dati che contiene la proprietà binaria entitydell'oggetto richiesto.

Nel protocollo AtomPub, l'oggetto entity è una voce di collegamento multimediale e la proprietà binaria è la risorsa multimediale associata.

Non viene eseguita alcuna convalida delle intestazioni impostate in args. Non modificare pertanto un'intestazione HTTP in un modo che determinerebbe la modifica del significato della richiesta.

Si applica a