DataServiceContext.SetSaveStream Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit un nouveau flux de données comme propriété binaire d'une entité.
Surcharges
| SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) |
Définit un nouveau flux de données comme propriété binaire d'une entité, avec les paramètres spécifiés dans le message de demande. |
| SetSaveStream(Object, Stream, Boolean, String, String) |
Définit un nouveau flux de données comme propriété binaire d'une entité. Les en-têtes Content-type et Slug spécifié sont inclus dans le message de demande. |
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)
Définit un nouveau flux de données comme propriété binaire d'une entité, avec les paramètres spécifiés dans le message de demande.
public:
void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::Data::Services::Client::DataServiceRequestArgs ^ args);public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, System.Data.Services.Client.DataServiceRequestArgs args);member this.SetSaveStream : obj * System.IO.Stream * bool * System.Data.Services.Client.DataServiceRequestArgs -> unitPublic Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)Paramètres
- entity
- Object
Entité qui a une propriété binaire à laquelle assigner le flux de données.
- closeStream
- Boolean
Valeur Boolean qui détermine si le flux de données est fermé lorsque la méthode SaveChanges() est terminée.
Instance de la classe DataServiceRequestArgs qui contient des paramètres pour le message de requête HTTP.
Exceptions
Tous les paramètres fournis à la méthode sont null.
L'entity n'est pas en cours de suivi par cette instance DataServiceContext.
- ou -
L'entity a le MediaEntryAttribute appliqué.
Remarques
La SetSaveStream méthode définit le flux binaire qui est la ressource multimédia associée à , entityqui est appelée entrée media link.
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.
Quand closeStream a la valeur true, la SaveChanges méthode ferme le flux avant qu’il ne retourne. 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.
S’applique à
SetSaveStream(Object, Stream, Boolean, String, String)
Définit un nouveau flux de données comme propriété binaire d'une entité. Les en-têtes Content-type et Slug spécifié sont inclus dans le message de demande.
public:
void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::String ^ contentType, System::String ^ slug);public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, string contentType, string slug);member this.SetSaveStream : obj * System.IO.Stream * bool * string * string -> unitPublic Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)Paramètres
- entity
- Object
Entité qui a une propriété binaire à laquelle assigner le flux de données.
- closeStream
- Boolean
Valeur Boolean qui détermine si le flux de données est fermé lorsque la méthode SaveChanges() est terminée.
- contentType
- String
Valeur d'en-tête Content-Type du message de requête.
- slug
- String
Valeur d'en-tête Slug du message de requête.
Exceptions
Tous les paramètres fournis à la méthode sont null.
L'entity n'est pas en cours de suivi par cette instance DataServiceContext.
- ou -
L'entity a le MediaEntryAttribute appliqué.
Remarques
La SetSaveStream méthode définit le flux binaire qui est la ressource multimédia associée à , entityqui est appelée entrée media link.
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.
Quand closeStream a la valeur true, la SaveChanges méthode ferme le flux avant qu’il ne retourne. 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.
