WebClient.OpenReadTaskAsync 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.
Apre un flusso leggibile contenente la risorsa specificata come operazione asincrona utilizzando un oggetto attività. Questi metodi non bloccano il thread chiamante.
Overload
OpenReadTaskAsync(String) |
Apre un flusso leggibile contenente la risorsa specificata come operazione asincrona utilizzando un oggetto attività. |
OpenReadTaskAsync(Uri) |
Apre un flusso leggibile contenente la risorsa specificata come operazione asincrona utilizzando un oggetto attività. |
OpenReadTaskAsync(String)
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
Apre un flusso leggibile contenente la risorsa specificata come operazione asincrona utilizzando un oggetto attività.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)
Parametri
- address
- String
L'URI della risorsa da recuperare.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce l'oggetto Stream utilizzato per leggere i dati da una risorsa.
- Attributi
Eccezioni
Il valore del parametro address
è null
.
L'URI composto dalla combinazione della proprietà BaseAddress con l'indirizzo non è valido.
-oppure-
Si è verificato un errore durante il download della risorsa.
-oppure-
Si è verificato un errore durante l'apertura del flusso.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo l'apertura di un flusso leggibile alla risorsa dati. Questo metodo non blocca il thread chiamante durante l'apertura del flusso.
Questo metodo recupera un'istanza Streamaddress
usata per accedere alla risorsa specificata dal parametro . Il flusso viene ottenuto usando le risorse del thread allocate automaticamente dal pool di thread.
Nota
È necessario chiamare al termine dell'operazione Stream.Close per evitare l'esaurimento Stream delle risorse di sistema.
In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone non completate chiamando il CancelAsync metodo .
Se la BaseAddress proprietà non è una stringa vuota ("") e address
non specifica un URI assoluto, address
deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto della risorsa richiesta. Se la QueryString proprietà non null
è , viene aggiunta a address
.
Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.
Nota
Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.
Vedi anche
Si applica a
OpenReadTaskAsync(Uri)
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
Apre un flusso leggibile contenente la risorsa specificata come operazione asincrona utilizzando un oggetto attività.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)
Parametri
- address
- Uri
L'URI della risorsa da recuperare.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce l'oggetto Stream utilizzato per leggere i dati da una risorsa.
- Attributi
Eccezioni
Il valore del parametro address
è null
.
L'URI composto dalla combinazione della proprietà BaseAddress con l'indirizzo non è valido.
-oppure-
Si è verificato un errore durante il download della risorsa.
-oppure-
Si è verificato un errore durante l'apertura del flusso.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo l'apertura di un flusso leggibile alla risorsa dati. Questo metodo non blocca il thread chiamante durante l'apertura del flusso.
Questo metodo recupera un'istanza Streamaddress
usata per accedere alla risorsa specificata dal parametro . Il flusso viene ottenuto usando le risorse del thread allocate automaticamente dal pool di thread.
Nota
È necessario chiamare al termine dell'operazione Stream.Close per evitare l'esaurimento Stream delle risorse di sistema.
In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone non completate chiamando il CancelAsync metodo .
Se la BaseAddress proprietà non è una stringa vuota ("") e address
non specifica un URI assoluto, address
deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto della risorsa richiesta. Se la QueryString proprietà non null
è , viene aggiunta a address
.
Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.
Nota
Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.
Vedi anche
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per