DataServiceContext.BeginGetReadStream Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.
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 entity
dell'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.