DataServiceContext.GetReadStream Метод

Определение

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

System.Data.Services.Client

Сборка:

System.Data.Services.Client.dll

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

Перегрузки

Имя	Описание
GetReadStream(Object)	Возвращает данные двоичного свойства для указанной сущности в виде потока данных.
GetReadStream(Object, DataServiceRequestArgs)	Возвращает данные двоичного свойства для указанной сущности в виде потока данных вместе с указанными заголовками сообщений.
GetReadStream(Object, String)	Возвращает данные двоичного свойства для указанной сущности в виде потока данных с указанным заголовком сообщения Accept.

GetReadStream(Object)

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

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream(object entity);

member this.GetReadStream : obj -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object) As DataServiceStreamResponse

Параметры

entity

Object

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

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

DataServiceStreamResponse

Экземпляр DataServiceStreamResponse , представляющий ответ.

Исключения

ArgumentNullException

Значение entity равно null.

ArgumentException

Это entity не отслеживается DataServiceContext.

–или–

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

–или–

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

Комментарии

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

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

GetReadStream(Object, DataServiceRequestArgs)

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

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream(object entity, System.Data.Services.Client.DataServiceRequestArgs args);

member this.GetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, args As DataServiceRequestArgs) As DataServiceStreamResponse

Параметры

entity

Object

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

args

DataServiceRequestArgs

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

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

DataServiceStreamResponse

Экземпляр DataServiceStreamResponse , представляющий ответ.

Исключения

ArgumentNullException

entity равно null.

–или–

args равно null.

ArgumentException

Это entity не отслеживается DataServiceContext.

–или–

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

–или–

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

Комментарии

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

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

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

GetReadStream(Object, String)

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

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::String ^ acceptContentType);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream(object entity, string acceptContentType);

member this.GetReadStream : obj * string -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, acceptContentType As String) As DataServiceStreamResponse

Параметры

entity

Object

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

acceptContentType

String

Тип контента, запрошенных службой данных, указанный в заголовке Accept.

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

DataServiceStreamResponse

Экземпляр DataServiceStreamResponse , представляющий ответ.

Исключения

ArgumentNullException

entity равно null.

–или–

acceptContentType равно null.

ArgumentException

Это entity не отслеживается DataServiceContext.

–или–

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

–или–

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

Комментарии

Параметр acceptContentType должен быть допустимым значением заголовка Accept HTTP.

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

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

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