DataServiceContext.BeginGetReadStream Méthode

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Obtient, de manière asynchrone, les données de propriété binaires pour l'entité spécifiée sous la forme d'un flux de données, ainsi que les en-têtes de message spécifiés.

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

Paramètres

entity

Object

Entité qui présente la propriété binaire à récupérer.

args

DataServiceRequestArgs

Instance de la classe DataServiceRequestArgs qui contient des paramètres pour le message de requête HTTP.

callback

AsyncCallback

Délégué à appeler lorsque les résultats sont disponibles pour un client.

state

Object

Objet d'état défini par l'utilisateur passé au rappel.

Retours

IAsyncResult

Objet IAsyncResult utilisé pour suivre l'état de l'opération asynchrone.

Exceptions

ArgumentNullException

Tous les paramètres fournis à la méthode sont null.

ArgumentException

L'entity n'est pas suivie par ce DataServiceContext.

- ou -

L'entity est à l'état Added.

- ou -

entity n'est pas une entrée de lien multimédia et n'a pas de propriété binaire.

Remarques

La GetReadStream méthode demande de manière asynchrone un flux de données qui contient la propriété binaire du demandé entity.

Dans le protocole AtomPub, est entity une entrée Media Link et la propriété binaire est la ressource multimédia associée.

Aucune validation n’est effectuée sur les en-têtes qui sont définis dans args. Par conséquent, ne modifiez pas un en-tête HTTP d'une façon qui modifie la signification de la requête.