WebClient (Clase)
Ensamblado: System (en system.dll)
La clase WebClient proporciona métodos comunes para intercambiar datos con cualquier recurso local, de intranet o de Internet identificado por un URI.
La clase WebClient utiliza la clase WebRequest para proporcionar acceso a los recursos. Las instancias de WebClient pueden obtener acceso a los datos a través de cualquier descendiente de WebRequest registrado con el método WebRequest.RegisterPrefix.
 Nota |
|---|
| De forma predeterminada, .NET Framework admite los identificadores URI que comiencen con los identificadores de esquema http:, https:, ftp: y file:. |
La tabla siguiente describe los métodos de WebClient para cargar datos en un recurso.
| Método | Descripción |
|---|---|
| Recupera un objeto Stream que se utiliza para enviar datos al recurso. | |
| Recupera un objeto Stream que se utiliza para enviar los datos al recurso, sin bloquear el subproceso que realiza la llamada. | |
| Envía una matriz de bytes al recurso y devuelve una matriz Byte que contiene las respuestas. | |
| Envía una matriz Byte al recurso, sin bloquear el subproceso que realiza la llamada. | |
| Envía un archivo local al recurso y devuelve una matriz Byte que contiene las respuestas. | |
| Envía un archivo local al recurso, sin bloquear el subproceso que realiza la llamada. | |
| Envía un objeto NameValueCollection al recurso y devuelve una matriz Byte que contiene las respuestas. | |
| Envía un objeto NameValueCollection al recurso y devuelve una matriz Byte que contiene las respuestas, sin bloquear el subproceso que realiza la llamada. | |
| Envía un objeto String al recurso, sin bloquear el subproceso que realiza la llamada. | |
| Envía un objeto String al recurso, sin bloquear el subproceso que realiza la llamada. |
La tabla siguiente describe los métodos de WebClient para descargar datos desde un recurso.
| Método | Descripción |
|---|---|
| Devuelve los datos de un recurso en forma de Stream. | |
| Devuelve los datos de un recurso, sin bloquear el subproceso que realiza la llamada. | |
| Descarga datos desde un recurso y devuelve una matriz Byte. | |
| Descarga datos desde un recurso y devuelve una matriz Byte, sin bloquear el subproceso que realiza la llamada. | |
| Descarga datos de un recurso en un archivo local. | |
| Descarga datos de un recurso en un archivo local, sin bloquear el subproceso que realiza la llamada. | |
| Descarga un objeto String de un recurso y devuelve un objeto String. | |
| Descarga un objeto String de un recurso, sin bloquear el subproceso que realiza la llamada. |
Puede utilizar el método CancelAsync para cancelar operaciones asincrónicas que no han finalizado.
Una instancia de WebClient no envía encabezados HTTP opcionales de forma predeterminada. Si la solicitud requiere un encabezado opcional, debe agregar el encabezado a la colección Headers. Por ejemplo, para conservar consultas en la respuesta, debe agregar un encabezado de agente de usuario. Asimismo, los servidores pueden devolver un error interno del servidor (500) si no se encuentra el encabezado de agente de usuario.
El valor de AllowAutoRedirect se establece en true en las instancias de WebClient.
Notas para los herederos Las clases derivadas deberían llamar a la implementación de la clase base de WebClient para garantizar que la clase derivada funciona como cabe esperar.En el ejemplo de código siguiente se toma el identificador URI de un recurso, se recupera y se muestra la respuesta.
using System; using System.Net; using System.IO; public class Test { public static void Main (string[] args) { if (args == null || args.Length == 0) { throw new ApplicationException ("Specify the URI of the resource to retrieve."); } WebClient client = new WebClient (); // Add a user agent header in case the // requested URI contains a query. client.Headers.Add ("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)"); Stream data = client.OpenRead (args[0]); StreamReader reader = new StreamReader (data); string s = reader.ReadToEnd (); Console.WriteLine (s); data.Close (); reader.Close (); } }
- WebPermission para obtener acceso al URI solicitado o a cualquier URI al que se haya redirigido la solicitud. Enumeración asociada: Connect.
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
