HttpContent.ReadAsStreamAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

Serializza il contenuto HTTP e restituisce un flusso che rappresenta il contenuto.

Overload

ReadAsStreamAsync()	Serializzare il contenuto HTTP e restituire un flusso che rappresenta il contenuto come operazione asincrona.
ReadAsStreamAsync(CancellationToken)	Serializzare il contenuto HTTP e restituire un flusso che rappresenta il contenuto come operazione asincrona.

Commenti

Si noti che questo metodo memorizza internamente nel buffer il contenuto, a meno che CreateContentReadStreamAsync() non sia stato implementato in altro modo.

ReadAsStreamAsync()

Origine:

HttpContent.cs

Serializzare il contenuto HTTP e restituire un flusso che rappresenta il contenuto come operazione asincrona.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync();

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync ();

member this.ReadAsStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function ReadAsStreamAsync () As Task(Of Stream)

Restituisce

Task<Stream>

Oggetto attività che rappresenta l'operazione asincrona.

Commenti

Questa operazione non verrà bloccata. L'oggetto Task<TResult> restituito verrà completato dopo la lettura di tutto il flusso che rappresenta il contenuto.

Al termine dell'operazione, la proprietà Result nell'oggetto attività restituito contiene il flusso che rappresenta il contenuto HTTP. Il flusso restituito può quindi essere usato per leggere il contenuto usando varie API di flusso.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadAsStream().

ReadAsStreamAsync(CancellationToken)

Origine:

HttpContent.cs

Serializzare il contenuto HTTP e restituire un flusso che rappresenta il contenuto come operazione asincrona.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync (System.Threading.CancellationToken cancellationToken);

member this.ReadAsStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function ReadAsStreamAsync (cancellationToken As CancellationToken) As Task(Of Stream)

Parametri

cancellationToken

CancellationToken

Token di annullamento per annullare l'operazione.

Restituisce

Task<Stream>

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto Task<TResult> restituito verrà completato dopo che tutto il flusso che rappresenta il contenuto è stato letto (a meno che CreateContentReadStream(CancellationToken) non sia stato implementato diversamente). Ad esempio, quando si usa HttpClient, un metodo come SendAsync restituisce una classe derivata da HttpContent che memorizza nel buffer in modo condizionale in base a ciò che viene passato per il parametro completionOption.

Al termine dell'operazione, la proprietà Result nell'oggetto attività restituito contiene il flusso che rappresenta il contenuto HTTP. Il flusso restituito può quindi essere usato per leggere il contenuto usando varie API di flusso.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadAsStream().