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 메서드를 호출하면 엔터티가 미디어 링크 항목으로 표시됩니다. 또한 다음에 SaveChanges 메서드를 호출할 때 해당 스트림이 데이터 서비스에 전송되도록 엔터티 상태가 Modified가 설정됩니다.
SetSaveStream 메서드는 Stream을 끝까지 읽습니다. Seek 작업은 Stream에서 시도되지 않습니다.
closeStream이 true이면 SaveChanges 메서드는 반환하기 전에 스트림을 닫습니다. 오류가 발생하고 스트림을 읽을 때도 스트림이 닫힙니다.
entity에 MediaEntryAttribute가 적용되면 미디어 리소스는 데이터 스트림이 될 수 없습니다. entity에 대한 데이터 스트림을 설정하기 전에 이 특성을 제거하십시오.
contentType 및 slug에 설정된 헤더에 대해서는 유효성 검사가 수행되지 않습니다. 따라서 요청의 의미를 변경하는 방식으로 이러한 HTTP 헤더를 변경하지 마십시오.