DataServiceContext.BeginGetReadStream 메서드 (Object, DataServiceRequestArgs, AsyncCallback, Object)
지정된 메시지 헤더를 사용하여 지정된 엔터티에 속한 이진 데이터 스트림을 비동기적으로 가져옵니다.
네임스페이스: System.Data.Services.Client
어셈블리: Microsoft.Data.Services.Client(Microsoft.Data.Services.Client.dll)
구문
‘선언
Public Function BeginGetReadStream ( _
entity As Object, _
args As DataServiceRequestArgs, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
‘사용 방법
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginGetReadStream(entity, _
args, callback, state)
public IAsyncResult BeginGetReadStream(
Object entity,
DataServiceRequestArgs args,
AsyncCallback callback,
Object state
)
public:
IAsyncResult^ BeginGetReadStream(
Object^ entity,
DataServiceRequestArgs^ args,
AsyncCallback^ callback,
Object^ state
)
member BeginGetReadStream :
entity:Object *
args:DataServiceRequestArgs *
callback:AsyncCallback *
state:Object -> IAsyncResult
public function BeginGetReadStream(
entity : Object,
args : DataServiceRequestArgs,
callback : AsyncCallback,
state : Object
) : IAsyncResult
매개 변수
- entity
유형: System.Object
검색할 이진 데이터 스트림이 있는 엔터티입니다.
- args
유형: System.Data.Services.Client.DataServiceRequestArgs
HTTP 요청 메시지에 대한 설정을 포함하는 DataServiceRequestArgs 클래스의 인스턴스입니다.
- callback
유형: System.AsyncCallback
결과를 클라이언트 소비에 사용할 수 있는 경우에 호출할 대리자입니다.
- state
유형: System.Object
콜백에 전달된 사용자 정의 상태 개체입니다.
반환 값
유형: System.IAsyncResult
비동기 작업의 상태를 추적하는 데 사용되는 IAsyncResult 개체입니다.
예외
| 예외 | 조건 |
|---|---|
| ArgumentNullException | 메서드에 제공된 매개 변수 중 하나가 nullnull 참조(Visual Basic에서는 Nothing)인 경우 |
| ArgumentException | entity가 이 DataServiceContext에서 추적되지 않는 경우 또는 entity가 Added 상태인 경우 또는 entity가 미디어 링크 항목이 아니고 관련된 이진 데이터 스트림이 없는 경우 |
주의
GetReadStream 메서드는 요청된 entity에 속한 이진 데이터 스트림을 비동기적으로 요청합니다.
AtomPub 프로토콜에서는 entity가 미디어 링크 항목이고 이진 데이터 스트림은 연결된 미디어 리소스입니다.
args에 설정된 헤더에 대해서는 유효성 검사가 수행되지 않습니다. 따라서 요청의 의미를 변경하는 방식으로 HTTP 헤더를 변경하지 마십시오.