Exportar (0) Imprimir
Expandir todo

WebClient (Clase)

Proporciona métodos comunes para intercambiar datos con un recurso identificado por un URI.

Espacio de nombres: System.Net
Ensamblado: System (en system.dll)

[ComVisibleAttribute(true)] 
public class WebClient : Component
/** @attribute ComVisibleAttribute(true) */ 
public class WebClient extends Component
ComVisibleAttribute(true) 
public class WebClient extends Component

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.

NotaNota

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

OpenWrite

Recupera un objeto Stream que se utiliza para enviar datos al recurso.

OpenWriteAsync

Recupera un objeto Stream que se utiliza para enviar los datos al recurso, sin bloquear el subproceso que realiza la llamada.

UploadData

Envía una matriz de bytes al recurso y devuelve una matriz Byte que contiene las respuestas.

UploadDataAsync

Envía una matriz Byte al recurso, sin bloquear el subproceso que realiza la llamada.

UploadFile

Envía un archivo local al recurso y devuelve una matriz Byte que contiene las respuestas.

UploadFileAsync

Envía un archivo local al recurso, sin bloquear el subproceso que realiza la llamada.

UploadValues

Envía un objeto NameValueCollection al recurso y devuelve una matriz Byte que contiene las respuestas.

UploadValuesAsync

Envía un objeto NameValueCollection al recurso y devuelve una matriz Byte que contiene las respuestas, sin bloquear el subproceso que realiza la llamada.

UploadString

Envía un objeto String al recurso, sin bloquear el subproceso que realiza la llamada.

UploadStringAsync

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

OpenRead

Devuelve los datos de un recurso en forma de Stream.

OpenReadAsync

Devuelve los datos de un recurso, sin bloquear el subproceso que realiza la llamada.

DownloadData

Descarga datos desde un recurso y devuelve una matriz Byte.

DownloadDataAsync

Descarga datos desde un recurso y devuelve una matriz Byte, sin bloquear el subproceso que realiza la llamada.

DownloadFile

Descarga datos de un recurso en un archivo local.

DownloadFileAsync

Descarga datos de un recurso en un archivo local, sin bloquear el subproceso que realiza la llamada.

DownloadString

Descarga un objeto String de un recurso y devuelve un objeto String.

DownloadStringAsync

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.

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft