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, чтобы не изменить значение запроса.

Применяется к