WebClient.OpenReadTaskAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea. Estos métodos no bloquean el subproceso que realiza la llamada.
Sobrecargas
OpenReadTaskAsync(String) |
Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea. |
OpenReadTaskAsync(Uri) |
Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea. |
OpenReadTaskAsync(String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
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
URI del recurso que se va a recuperar.
Devoluciones
Objeto de tarea que representa la operación asincrónica. La propiedad Result en el objeto de tarea devuelve Stream utilizado para leer datos de un recurso.
- Atributos
Excepciones
El parámetro address
es null
.
El URI obtenido mediante la combinación de BaseAddress y la dirección no es válido.
o bien
Se ha producido un error al descargar el recurso.
o bien
Se ha producido un error al abrir la secuencia.
Comentarios
Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de que se haya abierto una secuencia legible al recurso de datos. Este método no bloquea el subproceso que realiza la llamada mientras se abre la secuencia.
Este método recupera una Stream instancia de utilizada para tener acceso al recurso especificado por el address
parámetro . La secuencia se obtiene mediante recursos de subproceso que se asignan automáticamente desde el grupo de subprocesos.
Nota
Debe llamar cuando Stream.Close haya terminado con Stream para evitar quedarse sin recursos del sistema.
En .NET Framework y .NET Core 1.0, puede cancelar las operaciones asincrónicas que no se han completado llamando al CancelAsync método .
Si la BaseAddress propiedad no es una cadena vacía ("") y address
no especifica un URI absoluto, address
debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto del recurso solicitado. Si la QueryString propiedad no null
es , se anexa a address
.
Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.
Nota
Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.
Consulte también
Se aplica a
OpenReadTaskAsync(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
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
URI del recurso que se va a recuperar.
Devoluciones
Objeto de tarea que representa la operación asincrónica. La propiedad Result en el objeto de tarea devuelve Stream utilizado para leer datos de un recurso.
- Atributos
Excepciones
El parámetro address
es null
.
El URI obtenido mediante la combinación de BaseAddress y la dirección no es válido.
o bien
Se ha producido un error al descargar el recurso.
o bien
Se ha producido un error al abrir la secuencia.
Comentarios
Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de que se haya abierto una secuencia legible al recurso de datos. Este método no bloquea el subproceso que realiza la llamada mientras se abre la secuencia.
Este método recupera una Stream instancia de utilizada para tener acceso al recurso especificado por el address
parámetro . La secuencia se obtiene mediante recursos de subproceso que se asignan automáticamente desde el grupo de subprocesos.
Nota
Debe llamar cuando Stream.Close haya terminado con Stream para evitar quedarse sin recursos del sistema.
En .NET Framework y .NET Core 1.0, puede cancelar las operaciones asincrónicas que no se han completado llamando al CancelAsync método .
Si la BaseAddress propiedad no es una cadena vacía ("") y address
no especifica un URI absoluto, address
debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto del recurso solicitado. Si la QueryString propiedad no null
es , se anexa a address
.
Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.
Nota
Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.
Consulte también
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de