DataServiceContext.BeginGetReadStream Метод

Определение

Пространство имен:

System.Data.Services.Client

Сборка:

System.Data.Services.Client.dll

Выполняет асинхронное возвращение двоичных данных свойств для указанной сущности в виде потока данных (включая заголовки заданного сообщения).

public:
 IAsyncResult ^ BeginGetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginGetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args, AsyncCallback callback, object state);

member this.BeginGetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs * AsyncCallback * obj -> IAsyncResult

Public Function BeginGetReadStream (entity As Object, args As DataServiceRequestArgs, callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

entity

Object

Сущность, двоичное свойство которой необходимо извлечь.

args

DataServiceRequestArgs

Экземпляр класса DataServiceRequestArgs, содержащий параметры для сообщения HTTP-запроса.

callback

AsyncCallback

Делегат для вызова, когда результаты доступны для клиента.

state

Object

Определяемый пользователем объект состояния передается функции обратного вызова.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, используемый для отслеживания состояния асинхронной операции.

Исключения

ArgumentNullException

Все параметры, предоставленные этому методу, имеют значение null.

ArgumentException

Сущность entity не отслеживается этим контекстом DataServiceContext.

-или-

entity находится в состоянии Added.

-или-

Параметр entity не является записью ссылки на медиа-ресурс и не имеет двоичного свойства.

Комментарии

Метод GetReadStream асинхронно запрашивает поток данных, содержащий двоичное свойство запрошенного entityобъекта .

В протоколе AtomPub является записью entity ссылки на мультимедиа, а двоичное свойство — связанным ресурсом мультимедиа.

Проверка не выполняется в заголовках, которые заданы в args. Не изменяйте заголовок HTTP, чтобы не изменить значение запроса.