Méthode DataServiceContext.SetSaveStream (Object, Stream, Boolean, String, String)
Définit un flux de données binaires qui appartient à l'entité spécifiée, avec les en-têtes Content-Type et Slug 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, _
contentType As String, _
slug As String _
)
'Utilisation
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim contentType As String
Dim slug As String
instance.SetSaveStream(entity, stream, _
closeStream, contentType, slug)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
string contentType,
string slug
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
String^ contentType,
String^ slug
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
contentType:string *
slug:string -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
contentType : String,
slug : String
)
Paramètres
- entity
Type : System.Object
Entité à laquelle le flux de données 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.
- contentType
Type : System.String
Valeur d'en-tête Content-Type du message de requête.
- slug
Type : System.String
Valeur d'en-tête Slug du message de requête.
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 contentType et slug. Par conséquent, ne modifiez pas ces en-têtes HTTP d'une façon qui modifie la signification de la requête.