WebClient.OpenReadTaskAsync Método
Definição
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto de tarefa.Opens a readable stream containing the specified resource as an asynchronous operation using a task object. Esses métodos não bloqueiam o thread de chamada.These methods do not block the calling thread.
Sobrecargas
| OpenReadTaskAsync(String) |
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto de tarefa.Opens a readable stream containing the specified resource as an asynchronous operation using a task object. |
| OpenReadTaskAsync(Uri) |
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto de tarefa.Opens a readable stream containing the specified resource as an asynchronous operation using a task object. |
OpenReadTaskAsync(String)
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto de tarefa.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.
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)
Parâmetros
- address
- String
O URI do recurso a ser recuperado.The URI of the resource to retrieve.
Retornos
O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation. A propriedade Result no objeto da tarefa retorna um Stream usado para ler dados de um recurso.The Result property on the task object returns a Stream used to read data from a resource.
- Atributos
Exceções
O parâmetro address é null.The address parameter is null.
O URI formado pela combinação de BaseAddress e endereço é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Ocorreu um erro ao baixar o recurso.An error occurred while downloading the resource.
- ou --or-
Erro ao abrir o fluxo.An error occurred while opening the stream.
Comentários
Esta operação não será bloqueada.This operation will not block. O Task<TResult> objeto retornado será concluído após a abertura de um fluxo legível para o recurso de dados.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. Esse método não bloqueia o thread de chamada enquanto o fluxo está sendo aberto.This method does not block the calling thread while the stream is opening.
Esse método recupera uma Stream instância usada para acessar o recurso especificado pelo address parâmetro.This method retrieves a Stream instance used to access the resource specified by the address parameter. O fluxo é obtido usando recursos de thread que são alocados automaticamente do pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.
Observação
Você deve chamar Stream.Close quando terminar com o Stream para evitar a execução de recursos do sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.
No .NET Framework e no .NET Core 1,0, você pode cancelar as operações assíncronas que não foram concluídas chamando o CancelAsync método.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address especificar um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto do recurso solicitado.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 a QueryString propriedade não for null , ela será anexada a address .If the QueryString property is not null, it is appended to address.
Esse método usa o comando RETR para baixar um recurso de FTP.This method uses the RETR command to download an FTP resource. Para um recurso HTTP, o método GET é usado.For an HTTP resource, the GET method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.
Confira também
Aplica-se a
OpenReadTaskAsync(Uri)
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto de tarefa.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.
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)
Parâmetros
- address
- Uri
O URI do recurso a ser recuperado.The URI of the resource to retrieve.
Retornos
O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation. A propriedade Result no objeto da tarefa retorna um Stream usado para ler dados de um recurso.The Result property on the task object returns a Stream used to read data from a resource.
- Atributos
Exceções
O parâmetro address é null.The address parameter is null.
O URI formado pela combinação de BaseAddress e endereço é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Ocorreu um erro ao baixar o recurso.An error occurred while downloading the resource.
- ou --or-
Erro ao abrir o fluxo.An error occurred while opening the stream.
Comentários
Esta operação não será bloqueada.This operation will not block. O Task<TResult> objeto retornado será concluído após a abertura de um fluxo legível para o recurso de dados.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. Esse método não bloqueia o thread de chamada enquanto o fluxo está sendo aberto.This method does not block the calling thread while the stream is opening.
Esse método recupera uma Stream instância usada para acessar o recurso especificado pelo address parâmetro.This method retrieves a Stream instance used to access the resource specified by the address parameter. O fluxo é obtido usando recursos de thread que são alocados automaticamente do pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.
Observação
Você deve chamar Stream.Close quando terminar com o Stream para evitar a execução de recursos do sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.
No .NET Framework e no .NET Core 1,0, você pode cancelar as operações assíncronas que não foram concluídas chamando o CancelAsync método.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address especificar um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto do recurso solicitado.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 a QueryString propriedade não for null , ela será anexada a address .If the QueryString property is not null, it is appended to address.
Esse método usa o comando RETR para baixar um recurso de FTP.This method uses the RETR command to download an FTP resource. Para um recurso HTTP, o método GET é usado.For an HTTP resource, the GET method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.