Méthode DataServiceContext.BeginGetReadStream (Object, DataServiceRequestArgs, AsyncCallback, Object)
Obtient de façon asynchrone le flux de données binaires qui appartient à l'entité spécifiée, à l'aide des en-têtes de messages spécifiés.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Function BeginGetReadStream ( _
entity As Object, _
args As DataServiceRequestArgs, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Utilisation
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginGetReadStream(entity, _
args, callback, state)
public IAsyncResult BeginGetReadStream(
Object entity,
DataServiceRequestArgs args,
AsyncCallback callback,
Object state
)
public:
IAsyncResult^ BeginGetReadStream(
Object^ entity,
DataServiceRequestArgs^ args,
AsyncCallback^ callback,
Object^ state
)
member BeginGetReadStream :
entity:Object *
args:DataServiceRequestArgs *
callback:AsyncCallback *
state:Object -> IAsyncResult
public function BeginGetReadStream(
entity : Object,
args : DataServiceRequestArgs,
callback : AsyncCallback,
state : Object
) : IAsyncResult
Paramètres
- entity
Type : System.Object
Entité qui a un flux de données binaires à récupérer.
- args
Type : System.Data.Services.Client.DataServiceRequestArgs
Instance de la classe DataServiceRequestArgs qui contient des paramètres pour le message de requête HTTP.
- callback
Type : System.AsyncCallback
Délégué à appeler lorsque les résultats sont disponibles pour un client.
- state
Type : System.Object
Objet d'état défini par l'utilisateur passé au rappel.
Valeur de retour
Type : System.IAsyncResult
Objet IAsyncResult utilisé pour suivre l'état de l'opération asynchrone.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | L'un des paramètres fournis à la méthode est nullune référence Null (Nothing dans Visual Basic). |
| ArgumentException | L'entity n'est pas suivie par ce DataServiceContext. ou L'entity est à l'état Added. ou L'entity n'est pas une entrée de lien média et n'a pas de flux de données binaires associé. |
Notes
La méthode GetReadStream demande de façon asynchrone le flux de données binaires qui appartient à l'entity demandée.
Dans le protocole AtomPub, l'entity est une entrée de lien média et le flux de données binaires 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.