IDataServiceStreamProvider2.GetWriteStream 方法 (Object, ResourceProperty, String, Nullable<Boolean>, DataServiceOperationContext)
返回到数据服务用于写入从作为指定命名流的客户端接收的二进制数据媒体资源的流。
命名空间： System.Data.Services.Providers
程序集： Microsoft.Data.Services（在 Microsoft.Data.Services.dll 中）
语法
声明
Function GetWriteStream ( _
entity As Object, _
streamProperty As ResourceProperty, _
etag As String, _
checkETagForEquality As Nullable(Of Boolean), _
operationContext As DataServiceOperationContext _
) As Stream
用法
Dim instance As IDataServiceStreamProvider2
Dim entity As Object
Dim streamProperty As ResourceProperty
Dim etag As String
Dim checkETagForEquality As Nullable(Of Boolean)
Dim operationContext As DataServiceOperationContext
Dim returnValue As Stream
returnValue = instance.GetWriteStream(entity, _
streamProperty, etag, checkETagForEquality, _
operationContext)
Stream GetWriteStream(
Object entity,
ResourceProperty streamProperty,
string etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext operationContext
)
Stream^ GetWriteStream(
Object^ entity,
ResourceProperty^ streamProperty,
String^ etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext^ operationContext
)
abstract GetWriteStream :
entity:Object *
streamProperty:ResourceProperty *
etag:string *
checkETagForEquality:Nullable<bool> *
operationContext:DataServiceOperationContext -> Stream
function GetWriteStream(
entity : Object,
streamProperty : ResourceProperty,
etag : String,
checkETagForEquality : Nullable<boolean>,
operationContext : DataServiceOperationContext
) : Stream
参数
- entity
类型：System.Object
命名流所属的实体。
- streamProperty
类型：System.Data.Services.Providers.ResourceProperty
表示命名流的 ResourceProperty 对象。
- etag
类型：System.String
将 eTag 值作为数据服务的 HTTP 请求的一部分发送。
- checkETagForEquality
类型：System.Nullable<Boolean>
如果 eTag 被发送到 If-Match 标头，则确定条件请求颁发到数据服务的类型的可为空的 Boolean 值为 true，如果 eTag 被发送到 If-None-Match 标头，则该值为 false，如果请求没有条件并且请求中没有包含 eTag ，则该值为 nullnull 引用（在 Visual Basic 中为 Nothing）。
- operationContext
类型：System.Data.Services.DataServiceOperationContext
数据服务用于处理请求的 DataServiceOperationContext 实例。
返回值
类型：System.IO.Stream
有效的 Stream 数据服务用来写入二进制数据从客户端收到的内容。
注释
GetWriteStream 方法应永远不会返回 nullnull 引用（在 Visual Basic 中为 Nothing） 值。
operationContext 将补充作为参数，因为此接口方法的实现器将需要创建写入流的 HTTP 请求标头中的信息。 当你实现此方法时，您必须根据需要执行并发检查。 如果 If-Match 或 If-None-Match 请求标头包含在请求中，则 etag 将不会为 nullnull 引用（在 Visual Basic 中为 Nothing）。 在此情况下，这种方法必须执行适当的并发性检查。 如果通过并发检查，则此方法应返回所请求的流。 如果并发性检查失败，则该方法应通过适当的 HTTP 响应代码提高 DataServiceException。
当你实现此方法时，您必须不设置内容类型或 eTag HTTP 响应标头，因为他们由数据服务运行时设置。 您可以通过使用所提供的 operationContext 设置剩余 HTTP 响应标头。