DataServiceContext.GetReadStream Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает двоичные данные свойств для указанной сущности в виде потока данных.
Перегрузки
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, представляющий ответ.
Исключения
Значение параметра entity
— null
.
Сущность 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
Сущность, двоичное свойство которой необходимо извлечь.
Экземпляр класса DataServiceRequestArgs, содержащий параметры для сообщения HTTP-запроса.
Возвращаемое значение
Экземпляр DataServiceStreamResponse, представляющий ответ.
Исключения
Сущность 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, представляющий ответ.
Исключения
Сущность entity
не отслеживается этим контекстом DataServiceContext.
-или-
entity
находится в состоянии Added.
-или-
Параметр entity
не является записью ссылки на медиа-ресурс и не имеет двоичного свойства.
Комментарии
Параметр acceptContentType
должен быть допустимым значением для заголовка ACCEPT HTTP.
Метод GetReadStream синхронно запрашивает поток данных, содержащий двоичное свойство запрошенного entity
объекта .
В протоколе AtomPub является записью entity
ссылки на мультимедиа, а двоичное свойство — связанным ресурсом мультимедиа.
Проверка не выполняется в заголовках, которые заданы в acceptContentType
. Не изменяйте этот заголовок HTTP, чтобы не изменить значение запроса.