WebClient.OpenReadAsync WebClient.OpenReadAsync WebClient.OpenReadAsync WebClient.OpenReadAsync Method

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) OpenReadAsync(Uri) OpenReadAsync(Uri) 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) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) 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) OpenReadAsync(Uri) OpenReadAsync(Uri) 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 Uri Uri 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.

In alternativa-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 Stream usato per accedere alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to access the resource specified by the address parameter. Il flusso viene ottenuto utilizzando 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 notifica quando il flusso è disponibile, aggiungere un gestore eventi per il OpenReadCompleted evento.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le 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 viene aperto il flusso.This method does not block the calling thread while the stream is opening. Per bloccare l'attesa per il flusso, utilizzare il OpenReadAsync (metodo).To block while waiting for the stream, use the OpenReadAsync method.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da 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 il QueryString proprietà non è null, questo viene aggiunto a address.If the QueryString property is not null, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato 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 altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) 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 Uri Uri Uri

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

userToken
Object Object Object 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.

In alternativa-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 Stream usato per accedere alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to access the resource specified by the address parameter. Il flusso viene ottenuto utilizzando 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 notifica quando il flusso è disponibile, aggiungere un gestore eventi per il OpenReadCompleted evento.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le 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 viene aperto il flusso.This method does not block the calling thread while the stream is opening. Per bloccare l'attesa per il flusso, utilizzare il OpenRead (metodo).To block while waiting for the stream, use the OpenRead method.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da 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 il QueryString proprietà non è null, questo viene aggiunto a address.If the QueryString property is not null, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato 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 altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Si applica a