DataServiceContext.SetSaveStream 方法 (Object, Stream, Boolean, String, String)
使用请求消息中的指定 Content-Type 和 Slug 标头,设置属于指定实体的二进制数据流。
命名空间: 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, _
contentType As String, _
slug As String _
)
用法
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
)
参数
- entity
类型:System.Object
数据流所属的实体。
- stream
类型:System.IO.Stream
从中读取二进制数据的 Stream。
- closeStream
类型:System.Boolean
决定 SaveChanges 方法完成时是否关闭数据流的 Boolean 值。
- contentType
类型:System.String
请求消息的 Content-Type 标头值。
- slug
类型:System.String
请求消息的 Slug 标头值。
异常
异常 | 条件 |
---|---|
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 设置数据流之前,请移除此属性。
未对 contentType 和 slug 中设置的标头进行任何验证。 因此,请不要以更改请求含义的方式来更改这些 HTTP 标头。