DataServiceContext.SetSaveStream 方法

参考

定义

命名空间:: System.Data.Services.Client

程序集:: System.Data.Services.Client.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将新的数据流设置为实体的二进制属性。

重载

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	使用请求消息中的指定设置，将新的数据流设置为实体的二进制属性。
SetSaveStream(Object, Stream, Boolean, String, String)	将新的数据流设置为实体的二进制属性。指定的 Content-Type 和 Slug 标头包含在请求消息中。

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

使用请求消息中的指定设置，将新的数据流设置为实体的二进制属性。

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 -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)

参数

entity: Object

具有要为其分配数据流的二进制属性的实体。

stream: Stream

从中读取二进制数据的 Stream。

closeStream: Boolean

决定 Boolean 方法完成时是否关闭数据流的 SaveChanges() 值。

args: DataServiceRequestArgs

包含 HTTP 请求消息设置的 DataServiceRequestArgs 类的实例。

例外

ArgumentNullException

向方法提供的任何参数都为 null。

ArgumentException

entity 不是由此 DataServiceContext 实例进行跟踪。

- 或 -

entity 已应用 MediaEntryAttribute。

注解

方法 SetSaveStream 设置二进制流，该流是与 entity关联的媒体资源，称为媒体链接条目。

调用 SetSaveStream 方法将实体标记为媒体链接入口。实体状态也将设置为 Modified，以便在下次调用 SaveChanges 方法时将该流发送到数据服务。

SetSaveStream 方法从头到尾读取 Stream。未对 Seek 尝试 Stream 操作。

当为 true时closeStream，方法在SaveChanges返回流之前关闭流。即使出错且未读取该流，也会将其关闭。

当 entity 已应用 MediaEntryAttribute 时，媒体资源不能为数据流。在尝试为 entity 设置数据流之前，请移除此属性。

未对 args 中设置的标头进行任何验证。因此，请不要以更改请求含义的方式来更改 HTTP 标头。

适用于

SetSaveStream(Object, Stream, Boolean, String, String)

将新的数据流设置为实体的二进制属性。指定的 Content-Type 和 Slug 标头包含在请求消息中。

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 -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)

参数

entity: Object