Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase WebClient

 

Publicado: octubre de 2016

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

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


[ComVisibleAttribute(true)]
public class WebClient : Component

NombreDescripción
System_CAPS_pubmethodWebClient()

Inicializa una nueva instancia de la clase WebClient.

NombreDescripción
System_CAPS_pubpropertyAllowReadStreamBuffering

Obsoleto. Obtiene o establece un valor que indica si se debe almacenar en búfer los datos leídos desde el recurso de Internet para un WebClient instancia.

System_CAPS_pubpropertyAllowWriteStreamBuffering

Obsoleto. Obtiene o establece un valor que indica si se debe almacenar en búfer los datos escritos en el recurso de Internet para un WebClient instancia.

System_CAPS_pubpropertyBaseAddress

Obtiene o establece el URI base para las solicitudes realizadas por un WebClient.

System_CAPS_pubpropertyCachePolicy

Obtiene o establece la directiva de caché de la aplicación para los recursos obtenidos por esta instancia de WebClient mediante WebRequest objetos.

System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyCredentials

Obtiene o establece las credenciales de red que se envían al host y se usa para autenticar la solicitud.

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_pubpropertyEncoding

Obtiene y establece el Encoding utiliza para cargar y descargar cadenas.

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyHeaders

Obtiene o establece una colección de pares de nombre/valor de encabezado asociados a la solicitud.

System_CAPS_pubpropertyIsBusy

Obtiene si una solicitud Web está en curso.

System_CAPS_pubpropertyProxy

Obtiene o establece el proxy usado por este WebClient objeto.

System_CAPS_pubpropertyQueryString

Obtiene o establece una colección de pares de nombre/valor de consulta asociados con la solicitud.

System_CAPS_pubpropertyResponseHeaders

Obtiene una colección de pares de nombre/valor de encabezado asociados a la respuesta.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyUseDefaultCredentials

Obtiene o establece un Boolean valor que controla si el DefaultCredentials se envían con las solicitudes.

NombreDescripción
System_CAPS_pubmethodCancelAsync()

Cancela una operación asincrónica pendiente.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Heredado de Component).

System_CAPS_pubmethodDownloadData(String)

Descarga el recurso como un Byte matriz desde el URI especificado.

System_CAPS_pubmethodDownloadData(Uri)

Descarga el recurso como un Byte matriz desde el URI especificado.

System_CAPS_pubmethodDownloadDataAsync(Uri)

Descarga el recurso como un Byte matriz desde el URI especificado como una operación asincrónica.

System_CAPS_pubmethodDownloadDataAsync(Uri, Object)

Descarga el recurso como un Byte matriz desde el URI especificado como una operación asincrónica.

System_CAPS_pubmethodDownloadDataTaskAsync(String)

Descarga el recurso como un Byte matriz desde el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodDownloadDataTaskAsync(Uri)

Descarga el recurso como un Byte matriz desde el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodDownloadFile(String, String)

Descarga el recurso con el URI especificado en un archivo local.

System_CAPS_pubmethodDownloadFile(Uri, String)

Descarga el recurso con el URI especificado en un archivo local.

System_CAPS_pubmethodDownloadFileAsync(Uri, String)

En un archivo local, descarga el recurso con el URI especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodDownloadFileAsync(Uri, String, Object)

En un archivo local, descarga el recurso con el URI especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodDownloadFileTaskAsync(String, String)

Descarga el recurso especificado en un archivo local como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodDownloadFileTaskAsync(Uri, String)

Descarga el recurso especificado en un archivo local como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodDownloadString(String)

Descarga el recurso solicitado como un String. El recurso para descargar se especifica como un String que contiene el URI.

System_CAPS_pubmethodDownloadString(Uri)

Descarga el recurso solicitado como un String. El recurso para descargar se especifica como un Uri.

System_CAPS_pubmethodDownloadStringAsync(Uri)

Descarga el recurso especificado como un Uri. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodDownloadStringAsync(Uri, Object)

Descarga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodDownloadStringTaskAsync(String)

Descarga el recurso como un String desde el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodDownloadStringTaskAsync(Uri)

Descarga el recurso como un String desde el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodGetWebRequest(Uri)

Devuelve un WebRequest objeto para el recurso especificado.

System_CAPS_protmethodGetWebResponse(WebRequest)

Devuelve el objeto WebResponse correspondiente al objeto WebRequest especificado.

System_CAPS_protmethodGetWebResponse(WebRequest, IAsyncResult)

Devuelve el WebResponse especificado WebRequest usando el objeto IAsyncResult.

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_protmethodOnDownloadDataCompleted(DownloadDataCompletedEventArgs)

Genera el evento DownloadDataCompleted.

System_CAPS_protmethodOnDownloadFileCompleted(AsyncCompletedEventArgs)

Genera el evento DownloadFileCompleted.

System_CAPS_protmethodOnDownloadProgressChanged(DownloadProgressChangedEventArgs)

Genera el evento DownloadProgressChanged.

System_CAPS_protmethodOnDownloadStringCompleted(DownloadStringCompletedEventArgs)

Genera el evento DownloadStringCompleted.

System_CAPS_protmethodOnOpenReadCompleted(OpenReadCompletedEventArgs)

Genera el evento OpenReadCompleted.

System_CAPS_protmethodOnOpenWriteCompleted(OpenWriteCompletedEventArgs)

Genera el evento OpenWriteCompleted.

System_CAPS_protmethodOnUploadDataCompleted(UploadDataCompletedEventArgs)

Genera el evento UploadDataCompleted.

System_CAPS_protmethodOnUploadFileCompleted(UploadFileCompletedEventArgs)

Genera el evento UploadFileCompleted.

System_CAPS_protmethodOnUploadProgressChanged(UploadProgressChangedEventArgs)

Genera el evento UploadProgressChanged.

System_CAPS_protmethodOnUploadStringCompleted(UploadStringCompletedEventArgs)

Genera el evento UploadStringCompleted.

System_CAPS_protmethodOnUploadValuesCompleted(UploadValuesCompletedEventArgs)

Genera el evento UploadValuesCompleted.

System_CAPS_protmethodOnWriteStreamClosed(WriteStreamClosedEventArgs)

Obsoleto. Genera el evento WriteStreamClosed.

System_CAPS_pubmethodOpenRead(String)

Abre una secuencia legible de los datos descargada desde un recurso con el URI especificado como un String.

System_CAPS_pubmethodOpenRead(Uri)

Abre una secuencia legible de los datos descargada desde un recurso con el URI especificado como una Uri

System_CAPS_pubmethodOpenReadAsync(Uri)

Abre una secuencia legible que contiene el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodOpenReadAsync(Uri, Object)

Abre una secuencia legible que contiene el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodOpenReadTaskAsync(String)

Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodOpenReadTaskAsync(Uri)

Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodOpenWrite(String)

Abre una secuencia para escribir datos en el recurso especificado.

System_CAPS_pubmethodOpenWrite(String, String)

Abre una secuencia para escribir datos en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodOpenWrite(Uri)

Abre una secuencia para escribir datos en el recurso especificado.

System_CAPS_pubmethodOpenWrite(Uri, String)

Abre una secuencia para escribir datos en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodOpenWriteAsync(Uri)

Abre una secuencia para escribir datos en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodOpenWriteAsync(Uri, String)

Abre una secuencia para escribir datos en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodOpenWriteAsync(Uri, String, Object)

Abre una secuencia para escribir datos en el recurso especificado, utilizando el método especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodOpenWriteTaskAsync(String)

Abre una secuencia para escribir datos en el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodOpenWriteTaskAsync(String, String)

Abre una secuencia para escribir datos en el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodOpenWriteTaskAsync(Uri)

Abre una secuencia para escribir datos en el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodOpenWriteTaskAsync(Uri, String)

Abre una secuencia para escribir datos en el recurso especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

System_CAPS_pubmethodUploadData(String, Byte[])

Carga un búfer de datos en un recurso identificado por un URI.

System_CAPS_pubmethodUploadData(String, String, Byte[])

Carga un búfer de datos en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadData(Uri, Byte[])

Carga un búfer de datos en un recurso identificado por un URI.

System_CAPS_pubmethodUploadData(Uri, String, Byte[])

Carga un búfer de datos en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadDataAsync(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 de llamada.

System_CAPS_pubmethodUploadDataAsync(Uri, String, Byte[])

Carga un búfer de datos en un recurso identificado mediante un URI utilizando el método especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadDataAsync(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.

System_CAPS_pubmethodUploadDataTaskAsync(String, Byte[])

Carga un búfer de datos que contiene un Byte matriz al URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadDataTaskAsync(String, String, Byte[])

Carga un búfer de datos que contiene un Byte matriz al URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadDataTaskAsync(Uri, Byte[])

Carga un búfer de datos que contiene un Byte matriz al URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadDataTaskAsync(Uri, String, Byte[])

Carga un búfer de datos que contiene un Byte matriz al URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadFile(String, String)

Carga el archivo local especificado en un recurso con el URI especificado.

System_CAPS_pubmethodUploadFile(String, String, String)

Carga el archivo local especificado en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadFile(Uri, String)

Carga el archivo local especificado en un recurso con el URI especificado.

System_CAPS_pubmethodUploadFile(Uri, String, String)

Carga el archivo local especificado en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadFileAsync(Uri, String)

Carga el archivo local especificado en el recurso especificado mediante el método POST. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadFileAsync(Uri, String, String)

Carga el archivo local especificado en el recurso especificado mediante el método POST. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadFileAsync(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 de llamada.

System_CAPS_pubmethodUploadFileTaskAsync(String, String)

Carga el archivo local especificado en un recurso como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadFileTaskAsync(String, String, String)

Carga el archivo local especificado en un recurso como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadFileTaskAsync(Uri, String)

Carga el archivo local especificado en un recurso como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadFileTaskAsync(Uri, String, String)

Carga el archivo local especificado en un recurso como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadString(String, String)

Carga la cadena especificada en el recurso especificado mediante el método POST.

System_CAPS_pubmethodUploadString(String, String, String)

Carga la cadena especificada en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadString(Uri, String)

Carga la cadena especificada en el recurso especificado mediante el método POST.

System_CAPS_pubmethodUploadString(Uri, String, String)

Carga la cadena especificada en el recurso especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadStringAsync(Uri, String)

Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadStringAsync(Uri, String, String)

Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadStringAsync(Uri, String, String, Object)

Carga la cadena especificada en el recurso especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadStringTaskAsync(String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica mediante un objeto de tarea.

System_CAPS_pubmethodUploadStringTaskAsync(String, String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica mediante un objeto de tarea.

System_CAPS_pubmethodUploadStringTaskAsync(Uri, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica mediante un objeto de tarea.

System_CAPS_pubmethodUploadStringTaskAsync(Uri, String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica mediante un objeto de tarea.

System_CAPS_pubmethodUploadValues(String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado.

System_CAPS_pubmethodUploadValues(String, String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado por el URI especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadValues(Uri, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado.

System_CAPS_pubmethodUploadValues(Uri, String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado por el URI especificado, utilizando el método especificado.

System_CAPS_pubmethodUploadValuesAsync(Uri, NameValueCollection)

Carga los datos de la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadValuesAsync(Uri, String, NameValueCollection)

Carga los datos de la colección de nombre y valor especificado en el recurso identificado por el URI especificado, utilizando el método especificado. Este método no bloquea el subproceso de llamada.

System_CAPS_pubmethodUploadValuesAsync(Uri, String, NameValueCollection, Object)

Carga los datos de la colección de nombre y valor especificado en el recurso identificado por 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 finaliza la operación.

System_CAPS_pubmethodUploadValuesTaskAsync(String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadValuesTaskAsync(String, String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadValuesTaskAsync(Uri, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado como una operación asincrónica con un objeto de tarea.

System_CAPS_pubmethodUploadValuesTaskAsync(Uri, String, NameValueCollection)

Carga la colección de nombre y valor especificado en el recurso identificado mediante el URI especificado como una operación asincrónica con un objeto de tarea.

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

System_CAPS_pubeventDownloadDataCompleted

Se produce cuando finaliza una operación de descarga de datos asincrónica.

System_CAPS_pubeventDownloadFileCompleted

Se produce cuando finaliza una operación de descarga de archivos asincrónica.

System_CAPS_pubeventDownloadProgressChanged

Se produce cuando una operación de descarga asincrónica transfiere correctamente algunos o todos los datos.

System_CAPS_pubeventDownloadStringCompleted

Se produce cuando finaliza una operación de descarga de recursos asincrónica.

System_CAPS_pubeventOpenReadCompleted

Se produce cuando finaliza una operación asincrónica para abrir una secuencia que contiene un recurso.

System_CAPS_pubeventOpenWriteCompleted

Se produce cuando finaliza una operación asincrónica para abrir una secuencia para escribir datos en un recurso.

System_CAPS_pubeventUploadDataCompleted

Se produce cuando finaliza una operación de carga asincrónica de los datos.

System_CAPS_pubeventUploadFileCompleted

Se produce cuando finaliza una operación de carga de archivos asincrónica.

System_CAPS_pubeventUploadProgressChanged

Se produce cuando una operación de carga asincrónica transfiere correctamente algunos o todos los datos.

System_CAPS_pubeventUploadStringCompleted

Se produce cuando finaliza una operación de carga asincrónica de la cadena.

System_CAPS_pubeventUploadValuesCompleted

Se produce cuando finaliza la carga asincrónica de una colección de nombre y valor.

System_CAPS_pubeventWriteStreamClosed

Obsoleto. Se produce cuando una operación asincrónica para escribir datos en un recurso mediante una secuencia de escritura está cerrada.

La WebClient clase proporciona métodos comunes para enviar datos a o recibir datos desde cualquier local, intranet o recurso de Internet identificado por un URI.

La WebClient clase utiliza la WebRequest clase para proporcionar acceso a los recursos. WebClient instancias pueden tener acceso a datos con cualquier WebRequest descendiente registrado con el WebRequest.RegisterPrefix método.

System_CAPS_noteNota

De forma predeterminada, .NET Framework admite los identificadores URI que comienzan con http:, https:, ftp:, y file: identificadores de esquema.

La siguiente tabla describe WebClient métodos para cargar datos en un recurso.

Método

Descripción

OpenWrite

Recupera un Stream utiliza para enviar datos al recurso.

OpenWriteAsync

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

UploadData

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

UploadDataAsync

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

UploadFile

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

UploadFileAsync

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

UploadValues

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

UploadValuesAsync

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

UploadString

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

UploadStringAsync

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

La siguiente tabla describe WebClient métodos para descargar datos de un recurso.

Método

Descripción

OpenRead

Devuelve los datos de un recurso como un Stream.

OpenReadAsync

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

DownloadData

Descarga los datos desde un recurso y devuelve una Byte matriz.

DownloadDataAsync

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

DownloadFile

Descarga los datos desde un recurso en un archivo local.

DownloadFileAsync

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

DownloadString

Descarga un String desde un recurso y devuelve un String.

DownloadStringAsync

Descarga un String de un recurso, sin bloquear el subproceso que realiza la llamada.

Puede usar el CancelAsync método para cancelar operaciones asincrónicas que no se han completado.

Un WebClient instancia no envía encabezados HTTP opcionales de forma predeterminada. Si la solicitud requiere un encabezado opcional, debe agregar el encabezado a la Headers colección. Por ejemplo, para conservar consultas en la respuesta, debe agregar un encabezado de agente de usuario. Además, los servidores pueden devolver 500 (Error interno del servidor) si falta el encabezado de agente de usuario.

AllowAutoRedirect se establece en true en WebClient instancias.

Notas para desarrolladores de herederos:

Las clases derivadas deben llamar a la implementación de clase base WebClient para asegurarse de la clase derivada funciona según lo previsto.

En el ejemplo de código siguiente se toma el identificador URI de un recurso, se recupera y 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

to access the requested URI or any URI that the request is redirected to. Associated enumeration: F:System.Net.NetworkAccess.Connect.

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: