DataServiceContext.BeginGetReadStream Metoda

Definicja

Przestrzeń nazw:

System.Data.Services.Client

Zestaw:

System.Data.Services.Client.dll

Asynchronicznie pobiera dane właściwości binarnych dla określonej jednostki jako strumienia danych wraz z określonymi nagłówkami komunikatów.

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

Parametry

entity

Object

Jednostka, która ma właściwość binarną do pobrania.

args

DataServiceRequestArgs

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

callback

AsyncCallback

Delegowanie do wywoływania, gdy wyniki są dostępne dla użycia klienta.

state

Object

Obiekt stanu zdefiniowany przez użytkownika przekazany do wywołania zwrotnego.

Zwraca

IAsyncResult

IAsyncResult Obiekt używany do śledzenia stanu operacji asynchronicznej.

Wyjątki

ArgumentNullException

Dowolny z parametrów dostarczonych do metody to null.

ArgumentException

Element entity nie jest śledzony przez ten DataServiceContextelement .

-lub-

Wartość entity jest w Added stanie .

-lub-

Element entity nie jest wpisem łącza multimedialnego i nie ma właściwości binarnej.

Uwagi

Metoda GetReadStream asynchronicznie żąda strumienia danych zawierającego właściwość binarną żądanego entityobiektu .

W protokole AtomPub element jest wpisem łącza multimediów, entity a właściwość binarna jest skojarzonym zasobem multimediów.

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.