HttpContent.ReadAsStreamAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- Origine:
- HttpContent.cs
- 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
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().
Si applica a
ReadAsStreamAsync(CancellationToken)
- Origine:
- HttpContent.cs
- Origine:
- HttpContent.cs
- 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
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
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().