Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

WebClient (Clase)

Proporciona métodos comunes para enviar y recibir datos de un recurso identificado por un identificador URI.

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

[ComVisibleAttribute(true)]
public class WebClient : Component

El tipo WebClient expone los siguientes miembros.

  NombreDescripción
Método públicoWebClientInicializa una nueva instancia de la clase WebClient.
Arriba

  NombreDescripción
Propiedad públicaAllowReadStreamBuffering Obsoleto. Obtiene o establece un valor que indica si se deben almacenar en el búfer los datos leídos desde el recurso de Internet para una instancia de WebClient.
Propiedad públicaAllowWriteStreamBuffering Obsoleto. Obtiene o establece un valor que indica si se deben almacenar en el búfer los datos escritos en el recurso de Internet para una instancia de WebClient.
Propiedad públicaBaseAddressObtiene o establece el URI de base para las solicitudes realizadas por un WebClient.
Propiedad públicaCachePolicyObtiene o establece la directiva de caché de la aplicación para los recursos obtenidos por esta instancia de WebClient mediante objetos WebRequest.
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad públicaCredentialsObtiene o establece las credenciales de red que se envían al host y se utilizan para autenticar la solicitud.
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad públicaEncodingObtiene y establece el objeto Encoding utilizado para cargar y descargar cadenas.
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaHeadersObtiene o establece una colección de pares de nombre y valor de encabezado asociados a la solicitud.
Propiedad públicaIsBusyDetermina si hay una solicitud Web en curso.
Propiedad públicaProxyObtiene o establece el servidor proxy utilizado por este objeto WebClient.
Propiedad públicaQueryStringObtiene o establece una colección de pares de nombre y valor de consulta asociados a la solicitud.
Propiedad públicaResponseHeadersObtiene una colección de pares de nombre/valor de encabezado asociados a la respuesta.
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaUseDefaultCredentialsObtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.
Arriba

  NombreDescripción
Método públicoCancelAsyncCancela una operación asincrónica pendiente.
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Libera los recursos no administrados que utiliza Component y libera los recursos administrados de forma opcional. (Se hereda de Component).
Método públicoDownloadData(String)Descarga el recurso como una matriz de Byte desde el URI especificado.
Método públicoDownloadData(Uri)Descarga el recurso como una matriz de Byte desde el URI especificado.
Método públicoDownloadDataAsync(Uri)Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica.
Método públicoDownloadDataAsync(Uri, Object)Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica.
Método públicoDownloadDataTaskAsync(String)Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoDownloadDataTaskAsync(Uri)Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoDownloadFile(String, String)Descarga el recurso con el URI especificado en un archivo local.
Método públicoDownloadFile(Uri, String)Descarga el recurso con el URI especificado en un archivo local.
Método públicoDownloadFileAsync(Uri, String)Descarga en un archivo local el recurso con el URI especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoDownloadFileAsync(Uri, String, Object)Descarga en un archivo local el recurso con el URI especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoDownloadFileTaskAsync(String, String)Descarga el recurso especificado en un archivo local como operación asincrónica utilizando un objeto de tarea.
Método públicoDownloadFileTaskAsync(Uri, String)Descarga el recurso especificado en un archivo local como operación asincrónica utilizando un objeto de tarea.
Método públicoDownloadString(String)Descarga el recurso solicitado como String. El recurso para descargar se especifica como una String que contiene el URI.
Método públicoDownloadString(Uri)Descarga el recurso solicitado como String. El recurso que se descarga se especifica como un Uri.
Método públicoDownloadStringAsync(Uri)Descarga el recurso especificado como Uri. Este método no bloquea el subproceso que realiza la llamada.
Método públicoDownloadStringAsync(Uri, Object)Descarga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoDownloadStringTaskAsync(String)Descarga el recurso como un String desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoDownloadStringTaskAsync(Uri)Descarga el recurso como un String desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalizeLibera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método protegidoGetWebRequestDevuelve un objeto WebRequest para el recurso especificado.
Método protegidoGetWebResponse(WebRequest)Devuelve el objeto WebResponse correspondiente al objeto WebRequest especificado.
Método protegidoGetWebResponse(WebRequest, IAsyncResult)Devuelve el objeto WebResponse correspondiente al objeto WebRequest especificado utilizando el objeto IAsyncResult especificado.
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegidoOnDownloadDataCompletedGenera el evento DownloadDataCompleted.
Método protegidoOnDownloadFileCompletedGenera el evento DownloadFileCompleted.
Método protegidoOnDownloadProgressChangedGenera el evento DownloadProgressChanged.
Método protegidoOnDownloadStringCompletedGenera el evento DownloadStringCompleted.
Método protegidoOnOpenReadCompletedGenera el evento OpenReadCompleted.
Método protegidoOnOpenWriteCompletedGenera el evento OpenWriteCompleted.
Método protegidoOnUploadDataCompletedGenera el evento UploadDataCompleted.
Método protegidoOnUploadFileCompletedGenera el evento UploadFileCompleted.
Método protegidoOnUploadProgressChangedGenera el evento UploadProgressChanged.
Método protegidoOnUploadStringCompletedGenera el evento UploadStringCompleted.
Método protegidoOnUploadValuesCompletedGenera el evento UploadValuesCompleted.
Método protegidoOnWriteStreamClosed Obsoleto. Genera el evento WriteStreamClosed.
Método públicoOpenRead(String)Abre una secuencia legible de los datos descargados desde un recurso con el URI especificado como String.
Método públicoOpenRead(Uri)Abre una secuencia legible de los datos descargados desde un recurso con el URI especificado como Uri.
Método públicoOpenReadAsync(Uri)Abre una secuencia legible que contiene el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoOpenReadAsync(Uri, Object)Abre una secuencia legible que contiene el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoOpenReadTaskAsync(String)Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoOpenReadTaskAsync(Uri)Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoOpenWrite(String)Abre una secuencia para escribir datos en el recurso especificado.
Método públicoOpenWrite(Uri)Abre una secuencia para escribir datos en el recurso especificado.
Método públicoOpenWrite(String, String)Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado.
Método públicoOpenWrite(Uri, String)Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado.
Método públicoOpenWriteAsync(Uri)Abre una secuencia para escribir datos en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoOpenWriteAsync(Uri, String)Abre una secuencia para escribir datos en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoOpenWriteAsync(Uri, String, Object)Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoOpenWriteTaskAsync(String)Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoOpenWriteTaskAsync(Uri)Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoOpenWriteTaskAsync(String, String)Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoOpenWriteTaskAsync(Uri, String)Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoToStringDevuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este método no debe reemplazarse. (Se hereda de Component).
Método públicoUploadData(String, Byte[])Carga un búfer de datos en un recurso identificado por un URI.
Método públicoUploadData(Uri, Byte[])Carga un búfer de datos en un recurso identificado por un URI.
Método públicoUploadData(String, String, Byte[])Carga un búfer de datos en el recurso especificado, utilizando el método especificado.
Método públicoUploadData(Uri, String, Byte[])Carga un búfer de datos en el recurso especificado, utilizando el método especificado.
Método públicoUploadDataAsync(Uri, Byte[])Carga un búfer de datos en un recurso identificado mediante un URI utilizando el método POST. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadDataAsync(Uri, String, Byte[])Carga un búfer de datos en un recurso identificado mediante un URI utilizando el método POST. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadDataAsync(Uri, String, Byte[], Object)Carga un búfer de datos en un recurso identificado mediante un URI, utilizando el método especificado e identificando el token.
Método públicoUploadDataTaskAsync(String, Byte[])Carga un búfer de datos que contiene una matriz de Byte al URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadDataTaskAsync(Uri, Byte[])Carga un búfer de datos que contiene una matriz de Byte al URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadDataTaskAsync(String, String, Byte[])Carga un búfer de datos que contiene una matriz de Byte al URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadDataTaskAsync(Uri, String, Byte[])Carga un búfer de datos que contiene una matriz de Byte al URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadFile(String, String)Carga el archivo local especificado en un recurso con el URI especificado.
Método públicoUploadFile(Uri, String)Carga el archivo local especificado en un recurso con el URI especificado.
Método públicoUploadFile(String, String, String)Carga el archivo local especificado en el recurso especificado mediante el método especificado.
Método públicoUploadFile(Uri, String, String)Carga el archivo local especificado en el recurso especificado mediante el método especificado.
Método públicoUploadFileAsync(Uri, String)Carga el archivo local especificado en el recurso especificado mediante el método POST. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadFileAsync(Uri, String, String)Carga el archivo local especificado en el recurso especificado mediante el método POST. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadFileAsync(Uri, String, String, Object)Carga el archivo local especificado en el recurso especificado mediante el método POST. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadFileTaskAsync(String, String)Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.
Método públicoUploadFileTaskAsync(Uri, String)Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.
Método públicoUploadFileTaskAsync(String, String, String)Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.
Método públicoUploadFileTaskAsync(Uri, String, String)Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.
Método públicoUploadString(String, String)Carga la cadena especificada en el recurso especificado mediante el método POST.
Método públicoUploadString(Uri, String)Carga la cadena especificada en el recurso especificado mediante el método POST.
Método públicoUploadString(String, String, String)Carga la cadena especificada en el recurso especificado mediante el método especificado.
Método públicoUploadString(Uri, String, String)Carga la cadena especificada en el recurso especificado mediante el método especificado.
Método públicoUploadStringAsync(Uri, String)Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadStringAsync(Uri, String, String)Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadStringAsync(Uri, String, String, Object)Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadStringTaskAsync(String, String)Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadStringTaskAsync(Uri, String)Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadStringTaskAsync(String, String, String)Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadStringTaskAsync(Uri, String, String)Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadValues(String, NameValueCollection)Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado.
Método públicoUploadValues(Uri, NameValueCollection)Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado.
Método públicoUploadValues(String, String, NameValueCollection)Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado, utilizando el método especificado.
Método públicoUploadValues(Uri, String, NameValueCollection)Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado, utilizando el método especificado.
Método públicoUploadValuesAsync(Uri, NameValueCollection)Carga los datos de la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadValuesAsync(Uri, String, NameValueCollection)Carga los datos de la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado, utilizando el método especificado. Este método no bloquea el subproceso que realiza la llamada.
Método públicoUploadValuesAsync(Uri, String, NameValueCollection, Object)Carga los datos de la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado, utilizando el método especificado. Este método no bloquea el subproceso que realiza la llamada y permite al llamador pasar un objeto al método que se invoca cuando la operación finaliza.
Método públicoUploadValuesTaskAsync(String, NameValueCollection)Carga la colección de nombre/valor en el recurso identificado por el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadValuesTaskAsync(Uri, NameValueCollection)Carga la colección de nombre/valor en el recurso identificado por el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadValuesTaskAsync(String, String, NameValueCollection)Carga la colección de nombre/valor en el recurso identificado por el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Método públicoUploadValuesTaskAsync(Uri, String, NameValueCollection)Carga la colección de nombre/valor en el recurso identificado por el URI especificado como una operación asincrónica utilizando un objeto de tarea.
Arriba

  NombreDescripción
Evento públicoDisposedSe produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento públicoDownloadDataCompletedSe produce cuando finaliza una operación de descarga de datos asincrónica.
Evento públicoDownloadFileCompletedSe produce cuando finaliza una operación de descarga de archivo asincrónica.
Evento públicoDownloadProgressChangedSe produce cuando una operación de descarga asincrónica transfiere correctamente una parte o la totalidad de los datos.
Evento públicoDownloadStringCompletedSe produce cuando finaliza una operación de descarga de recursos asincrónica.
Evento públicoOpenReadCompletedSe produce cuando finaliza una operación asincrónica para abrir una secuencia que contiene un recurso.
Evento públicoOpenWriteCompletedSe produce cuando se completa una operación asincrónica para abrir una secuencia para escribir datos en un recurso.
Evento públicoUploadDataCompletedSe produce cuando finaliza una operación de carga de datos asincrónica.
Evento públicoUploadFileCompletedSe produce cuando finaliza una operación de carga de archivos asincrónica.
Evento públicoUploadProgressChangedSe produce cuando una operación de carga asincrónica transfiere correctamente una parte o la totalidad de los datos.
Evento públicoUploadStringCompletedSe produce cuando se completa una operación de carga de cadenas asincrónica.
Evento públicoUploadValuesCompletedSe produce cuando finaliza una operación de carga asincrónica de una colección de nombres y valores.
Evento públicoWriteStreamClosed Obsoleto. Se produce cuando se cierra una operación asincrónica para escribir datos en un recurso usando una secuencia de escritura.
Arriba

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 WebClient pueden tener acceso a datos con cualquier descendiente 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: 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 ();
    }
}


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

  • WebPermission 

    para obtener acceso al URI solicitado o a cualquier URI al que se haya redirigido la solicitud. Enumeración asociada: Connect.

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft