Udostępnij za pośrednictwem


DataServiceContext.BeginGetReadStream Metoda

Definicja

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 Obiekt używany do śledzenia stanu operacji asynchronicznej.

Wyjątki

Dowolny z parametrów dostarczonych do metody to null.

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.

Dotyczy