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
데이터 서비스에 전송되는 HTTP 요청의 일부로 보낸 eTag 값입니다.
- checkETagForEquality
유형: System.Nullable<Boolean>
데이터 서비스에 실행된 조건부 요청의 종류를 확인하는 null을 허용하는 Boolean 값입니다. eTag가 If-Match 헤더로 전송된 경우 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 응답 헤더를 설정해서는 안 됩니다. 콘텐츠 형식 또는 eTag HTTP 응답 헤더는 데이터 서비스 런타임에서 설정됩니다. 나머지 HTTP 응답 헤더는 제공된 operationContext를 사용하여 설정할 수 있습니다.