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