DataServiceContext.SetSaveStream 方法 (Object, Stream, Boolean, DataServiceRequestArgs)
使用请求消息中的指定标头,为指定实体设置二进制数据流。
命名空间: System.Data.Services.Client
程序集: Microsoft.Data.Services.Client(在 Microsoft.Data.Services.Client.dll 中)
语法
声明
Public Sub SetSaveStream ( _
entity As Object, _
stream As Stream, _
closeStream As Boolean, _
args As DataServiceRequestArgs _
)
用法
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
)
参数
- entity
类型:System.Object
二进制流所属的实体。
- stream
类型:System.IO.Stream
从中读取二进制数据的 Stream。
- closeStream
类型:System.Boolean
决定 SaveChanges 方法完成时是否关闭数据流的 Boolean 值。
- args
类型:System.Data.Services.Client.DataServiceRequestArgs
包含 HTTP 请求消息设置的 DataServiceRequestArgs 类的实例。
异常
异常 | 条件 |
---|---|
ArgumentNullException | 提供给该方法的任何参数均为 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
ArgumentException | entity 不是由此 DataServiceContext 实例进行跟踪。 - 或 - entity 已应用 MediaEntryAttribute。 |
注释
SetSaveStream 方法设置了二进制流,即属于 entity(称为媒体链接入口)的媒体资源。
调用 SetSaveStream 方法将实体标记为媒体链接入口。 实体状态也将设置为 Modified,以便在下次调用 SaveChanges 方法时将该流发送到数据服务。
SetSaveStream 方法从头到尾读取 Stream。 未对 Stream 尝试 Seek 操作。
当 closeStream 为 true 时, SaveChanges 方法在返回之前关闭流。 即使出错且未读取该流,也会将其关闭。
当 entity 已应用 MediaEntryAttribute 时,媒体资源不能为数据流。 在尝试为 entity 设置数据流之前,请移除此属性。
未对 args 中设置的标头进行任何验证。 因此,请不要以更改请求含义的方式来更改 HTTP 标头。