DataServiceContext.BeginGetReadStream Metodo

Definizione

Spazio dei nomi:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

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

IAsyncResult

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

Eccezioni

ArgumentNullException

Uno dei parametri forniti al metodo è null.

ArgumentException

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.