DataServiceContext.SetSaveStream Метод

Определение

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

System.Data.Services.Client

Сборка:

System.Data.Services.Client.dll

Назначает новый поток данных двоичным свойством какой-либо сущности.

Перегрузки

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Назначает новый поток данных двоичным свойством какой-либо сущности с учетом параметров, указанных в сообщении запроса.
SetSaveStream(Object, Stream, Boolean, String, String)	Назначает новый поток данных двоичным свойством какой-либо сущности. Указанные заголовки Content-Type и Slug включены в сообщение запроса.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Назначает новый поток данных двоичным свойством какой-либо сущности с учетом параметров, указанных в сообщении запроса.

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, System.Data.Services.Client.DataServiceRequestArgs args);

member this.SetSaveStream : obj * System.IO.Stream * bool * System.Data.Services.Client.DataServiceRequestArgs -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)

Параметры

entity

Object

Сущность, имеющая двоичное свойство, которому необходимо назначить поток данных.

stream

Stream

Stream, из которого считываются двоичные данные.

closeStream

Boolean

Значение Boolean, определяющее, закрыт ли поток данных при завершении метода SaveChanges().

args

DataServiceRequestArgs

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

Исключения

ArgumentNullException

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

ArgumentException

entity не отслеживается этим экземпляром DataServiceContext.

-или-

У сущности entity есть атрибут MediaEntryAttribute.

Комментарии

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

Вызов метода SetSaveStream помечает сущности как записи медиассылки. Состояние сущности также задается в Modified таким образом, чтобы поток направлялся в службу данных при следующем вызове метода SaveChanges.

Метод SetSaveStream считывает Stream до конца. Не происходит попытки выполнить операцию Seek для Stream.

Если closeStream имеет значение true, SaveChanges метод закрывает поток перед возвратом. Поток закрыт даже тогда, когда возникает ошибка и поток не считывается.

Если у сущности entity есть атрибут MediaEntryAttribute, то медиаресурс не может быть потоком данных. Уделите этот атрибут перед заданием потока данных для entity.

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

SetSaveStream(Object, Stream, Boolean, String, String)

Назначает новый поток данных двоичным свойством какой-либо сущности. Указанные заголовки Content-Type и Slug включены в сообщение запроса.

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::String ^ contentType, System::String ^ slug);

public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, string contentType, string slug);

member this.SetSaveStream : obj * System.IO.Stream * bool * string * string -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)

Параметры

entity

Object

Сущность, имеющая двоичное свойство, которому необходимо назначить поток данных.

stream

Stream

Stream, из которого считываются двоичные данные.

closeStream

Boolean

Значение Boolean, определяющее, закрыт ли поток данных при завершении метода SaveChanges().

contentType

String

Значение заголовка Content-Type для сообщения запроса.

slug

String

Значение заголовка Slug для сообщения запроса.

Исключения

ArgumentNullException

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

ArgumentException

entity не отслеживается этим экземпляром DataServiceContext.

-или-

У сущности entity есть атрибут MediaEntryAttribute.

Комментарии

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

Вызов метода SetSaveStream помечает сущности как медиассылки. Состояние сущности также задается в Modified таким образом, чтобы поток направлялся в службу данных при следующем вызове метода SaveChanges.

Метод SetSaveStream считывает Stream до конца. Не происходит попытки выполнить операцию Seek для Stream.

Если closeStream имеет значение true, SaveChanges метод закрывает поток перед возвратом. Поток закрыт даже тогда, когда возникает ошибка и поток не считывается.

Если у сущности entity есть атрибут MediaEntryAttribute, то медиаресурс не может быть потоком данных. Уделите этот атрибут перед заданием потока данных для entity.

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