Méthode DataServiceContext.SetSaveStream (Object, Stream, Boolean, DataServiceRequestArgs)
Définit un flux de données binaires pour l'entité spécifiée, avec les en-têtes spécifiés dans le message de requête.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Sub SetSaveStream ( _
entity As Object, _
stream As Stream, _
closeStream As Boolean, _
args As DataServiceRequestArgs _
)
'Utilisation
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim args As DataServiceRequestArgs
instance.SetSaveStream(entity, stream, _
closeStream, args)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
DataServiceRequestArgs args
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
DataServiceRequestArgs^ args
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
args:DataServiceRequestArgs -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
args : DataServiceRequestArgs
)
Paramètres
- entity
Type : System.Object
Entité à laquelle le flux binaire appartient.
- stream
Type : System.IO.Stream
Stream à partir duquel lire les données binaires.
- closeStream
Type : System.Boolean
Valeur Boolean qui détermine si le flux de données est fermé lorsque la méthode SaveChanges est terminée.
- args
Type : System.Data.Services.Client.DataServiceRequestArgs
Instance de la classe DataServiceRequestArgs qui contient des paramètres pour le message de requête HTTP.
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 en cours de suivi par cette instance DataServiceContext. ou L'entity a le MediaEntryAttribute appliqué. |
Notes
La méthode SetSaveStream définit le flux binaire qui est la ressource multimédia qui appartient à l'entity, appelée entrée de lien média.
L'appel de la méthode SetSaveStream marque l'entité comme une entrée de lien média. L'état de l'entité est également défini sur Modified afin que le flux soit envoyé au service de données la prochaine fois que la méthode SaveChanges est appelée.
La méthode SetSaveStream lit le Stream jusqu'à la fin. Une opération Seek n'est pas tentée sur le Stream.
Lorsque closeStream est true, la méthode SaveChanges ferme le flux de données avant son retour. Le flux est fermé même lorsqu'une erreur se produit et que le flux n'est pas lu.
Lorsque l'entity a le MediaEntryAttribute appliqué, la ressource multimédia ne peut pas être un flux de données. Supprimez cet attribut avant d'essayer de définir le flux de données de l'entity.
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.