DataServiceContext.SetSaveStream Metoda

Definicja

Przestrzeń nazw:

System.Data.Services.Client

Zestaw:

System.Data.Services.Client.dll

Ustawia nowy strumień danych jako właściwość binarną jednostki.

Przeciążenia

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Ustawia nowy strumień danych jako właściwość binarną jednostki z określonymi ustawieniami w komunikacie żądania.
SetSaveStream(Object, Stream, Boolean, String, String)	Ustawia nowy strumień danych jako właściwość binarną jednostki. Określone nagłówki Content-Type i Slug są uwzględniane w komunikacie żądania.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Ustawia nowy strumień danych jako właściwość binarną jednostki z określonymi ustawieniami w komunikacie żądania.

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)

Parametry

entity

Object

Jednostka, która ma właściwość binarną, do której ma zostać przypisany strumień danych.

stream

Stream

Element Stream , z którego mają być odczytywane dane binarne.

closeStream

Boolean

Boolean Wartość określająca, czy strumień danych jest zamknięty po zakończeniu SaveChanges() metody.

args

DataServiceRequestArgs

Wystąpienie DataServiceRequestArgs klasy zawierające ustawienia komunikatu żądania HTTP.

Wyjątki

ArgumentNullException

Dowolny z parametrów dostarczonych do metody to null.

ArgumentException

Element entity nie jest śledzony przez to DataServiceContext wystąpienie.

-lub-

Element entity ma MediaEntryAttribute zastosowane.

Uwagi

Metoda SetSaveStream ustawia strumień binarny, który jest zasobem nośnika skojarzonym z elementem entity, który jest nazywany wpisem łącza multimediów.

SetSaveStream Wywołanie metody oznacza jednostkę jako wpis linku do multimediów. Stan jednostki jest również ustawiony tak Modified , aby strumień został wysłany do usługi danych przy następnym SaveChanges wywołaniu metody.

Metoda SetSaveStream odczytuje Stream do końca. Operacja nie jest podejmowana Seek w obiekcie Stream.

Gdy closeStream jest to true, SaveChanges metoda zamyka strumień przed jego zwróceniem. Strumień jest zamykany nawet wtedy, gdy wystąpi błąd, a strumień nie jest odczytywany.

Po zastosowaniu entityMediaEntryAttribute zasób nośnika nie może być strumieniem danych. Usuń ten atrybut przed próbą ustawienia strumienia danych dla elementu entity.

W nagłówkach ustawionych w argselemecie nie jest wykonywana walidacja. W związku z tym nie należy zmieniać nagłówka HTTP w sposób, który zmienia znaczenie żądania.

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

Ustawia nowy strumień danych jako właściwość binarną jednostki. Określone nagłówki Content-Type i Slug są uwzględniane w komunikacie żądania.

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)

Parametry

entity

Object

Jednostka, która ma właściwość binarną, do której ma zostać przypisany strumień danych.

stream

Stream

Element Stream , z którego mają być odczytywane dane binarne.

closeStream

Boolean

Boolean Wartość określająca, czy strumień danych jest zamknięty po zakończeniu SaveChanges() metody.

contentType

String

Wartość nagłówka Content-Type dla komunikatu żądania.

slug

String

Wartość nagłówka Slug dla komunikatu żądania.

Wyjątki

ArgumentNullException

Dowolny z parametrów dostarczonych do metody to null.

ArgumentException

Element entity nie jest śledzony przez to DataServiceContext wystąpienie.

-lub-

Element entity ma MediaEntryAttribute zastosowane.

Uwagi

Metoda SetSaveStream ustawia strumień binarny, który jest zasobem nośnika skojarzonym z elementem entity, który jest nazywany wpisem łącza multimediów.

SetSaveStream Wywołanie metody oznacza jednostkę jako wpis linku multimediów. Stan jednostki jest również ustawiony tak Modified , aby strumień został wysłany do usługi danych przy następnym SaveChanges wywołaniu metody.

Metoda SetSaveStream odczytuje Stream do końca. Operacja nie jest podejmowana Seek w obiekcie Stream.

Gdy closeStream jest to true, SaveChanges metoda zamyka strumień przed jego zwróceniem. Strumień jest zamykany nawet wtedy, gdy wystąpi błąd, a strumień nie jest odczytywany.

Po zastosowaniu entityMediaEntryAttribute zasób nośnika nie może być strumieniem danych. Usuń ten atrybut przed próbą ustawienia strumienia danych dla elementu entity.

Żadna walidacja nie jest wykonywana w nagłówkach ustawionych w contentType elementach i slug. W związku z tym nie należy zmieniać tych nagłówków HTTP w sposób, który zmienia znaczenie żądania.