Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.OpenReadTaskAsync (String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Apre un flusso leggibile che contiene la risorsa specificata come un'operazione asincrona mediante un oggetto di attività.

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public Task<Stream> OpenReadTaskAsync(
	string address
)

Parametri

address
Type: System.String

L'URI della risorsa da recuperare.

Valore restituito

Type: System.Threading.Tasks.Task<Stream>

Restituisce Task<TResult>.

Oggetto dell'attività che rappresenta l'operazione asincrona. Il Result proprietà nell'oggetto attività restituisce un Stream utilizzata per leggere dati da una risorsa.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI formato dalla combinazione BaseAddress e indirizzo non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> oggetto verrà completata dopo il flusso leggibile alla risorsa di dati è stata aperta. Questo metodo non blocca il thread chiamante durante l'apertura del flusso.

Questo metodo recupera un Stream utilizzato per accedere alla risorsa specificata dall'istanza di address parametro. Il flusso viene ottenuto utilizzando le risorse thread allocate automaticamente dal pool di thread.

System_CAPS_noteNota

È necessario chiamare Stream.Close quando si è finito con il Stream per evitare di esaurire le risorse di sistema.

Operazioni asincrone che non sono state completate possono essere annullate utilizzando il CancelAsync metodo.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un URI assoluto, address deve essere un URI relativo viene combinato con BaseAddress per formare l'URI assoluto della risorsa richiesta. Se il QueryString proprietà non è null, questo viene aggiunto a address.

Questo metodo utilizza il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo GET.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

.NET Framework
Disponibile da 4.5
Torna all'inizio
Mostra: