WebClient.OpenReadAsync Metodo

Definizione

Apre un flusso in lettura contenente la risorsa specificata.Opens a readable stream containing the specified resource. Questi metodi non bloccano il thread chiamante.These methods do not block the calling thread.

Overload

OpenReadAsync(Uri)

Apre un flusso in lettura contenente la risorsa specificata.Opens a readable stream containing the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

OpenReadAsync(Uri, Object)

Apre un flusso in lettura contenente la risorsa specificata.Opens a readable stream containing the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

OpenReadAsync(Uri)

Apre un flusso in lettura contenente la risorsa specificata.Opens a readable stream containing the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void OpenReadAsync(Uri ^ address);
public void OpenReadAsync (Uri address);
member this.OpenReadAsync : Uri -> unit
Public Sub OpenReadAsync (address As Uri)

Parametri

address
Uri

L'URI della risorsa da recuperare.The URI of the resource to retrieve.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

L'URI composto dalla combinazione della proprietà BaseAddress con l'indirizzo non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or- Si è verificato un errore durante il download della risorsa.An error occurred while downloading the resource.

-oppure--or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

Commenti

Questo metodo recupera un'istanza Stream utilizzata per accedere alla risorsa specificata dal parametro address.This method retrieves a Stream instance used to access the resource specified by the address parameter. Il flusso viene ottenuto usando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool. Per ricevere una notifica quando il flusso è disponibile, aggiungere un gestore eventi all'evento OpenReadCompleted.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Nota

Al termine della Stream, è necessario chiamare Stream.Close per evitare l'esaurimento delle risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Questo metodo non blocca il thread chiamante mentre è in corso l'apertura del flusso.This method does not block the calling thread while the stream is opening. Per bloccare l'attesa del flusso, usare il metodo OpenReadAsync.To block while waiting for the stream, use the OpenReadAsync method.

Le operazioni asincrone che non sono state completate possono essere annullate usando il metodo CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se la proprietà BaseAddress 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.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. Se la proprietà QueryString non è null, viene aggiunta a address.If the QueryString property is not null, it is appended to address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene usato il metodo GET.For an HTTP resource, the GET method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete nel .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenReadAsync(Uri, Object)

Apre un flusso in lettura contenente la risorsa specificata.Opens a readable stream containing the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);
public void OpenReadAsync (Uri address, object userToken);
member this.OpenReadAsync : Uri * obj -> unit
Public Sub OpenReadAsync (address As Uri, userToken As Object)

Parametri

address
Uri

L'URI della risorsa da recuperare.The URI of the resource to retrieve.

userToken
Object

Oggetto definito dall'utente passato al metodo richiamato al completamento dell'operazione asincrona.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

L'URI composto dalla combinazione della proprietà BaseAddress con l'indirizzo non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or- Si è verificato un errore durante il download della risorsa.An error occurred while downloading the resource.

In alternativa-or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

Commenti

Questo metodo recupera un'istanza Stream utilizzata per accedere alla risorsa specificata dal parametro address.This method retrieves a Stream instance used to access the resource specified by the address parameter. Il flusso viene ottenuto usando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool. Per ricevere una notifica quando il flusso è disponibile, aggiungere un gestore eventi all'evento OpenReadCompleted.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Nota

Al termine della Stream, è necessario chiamare Stream.Close per evitare l'esaurimento delle risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Questo metodo non blocca il thread chiamante mentre è in corso l'apertura del flusso.This method does not block the calling thread while the stream is opening. Per bloccare l'attesa del flusso, usare il metodo OpenRead.To block while waiting for the stream, use the OpenRead method.

Le operazioni asincrone che non sono state completate possono essere annullate usando il metodo CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se la proprietà BaseAddress 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.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. Se la proprietà QueryString non è null, viene aggiunta a address.If the QueryString property is not null, it is appended to address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene usato il metodo GET.For an HTTP resource, the GET method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete nel .NET Framework.For more information, see Network Tracing in the .NET Framework.

Si applica a