La clase WebClient utiliza la clase WebRequest para proporcionar acceso a los recursos.

Debe utilizar la clase WebClient de un control de Silverlight que se hospeda en una página web.

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

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

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

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.

Algunos encabezados se consideran restringidos y se exponen directamente (como Content-Type) o están protegidos por el sistema y no se pueden establecer en un objeto WebHeaderCollection. Cualquier intento de establecer uno de estos encabezados restringidos en el objeto WebHeaderCollection mediante la propiedad Item[([(String])]) o Item[([(HttpRequestHeader])]) produce una excepción. Si el objeto WebHeaderCollection está asociado a un objeto HttpWebRequest, la propiedad Item[([(HttpRequestHeader])]) produce la excepción. Si el objeto WebHeaderCollection está asociado a un objeto WebClient, la excepción se produce al intentar enviar la solicitud de WebClient.

Para obtener una lista de encabezados restringidos, consulte la sección Comentarios de la clase WebHeaderCollection.

Silverlight versión 2 es compatible con la conectividad entre dominios, que permite a una aplicación obtener acceso a los recursos situados en ubicaciones distintas del sitio de origen. Se trata de una característica importante para que las aplicaciones de Silverlight puedan utilizar los servicios existentes en la Web. El sistema de directivas de seguridad en el tiempo de ejecución de Silverlight 2 requiere ahora que se descargue un archivo de directivas desde un recurso de red antes de permitir a una conexión de red tener acceso a ese recurso. Este sistema de directivas de seguridad afecta al acceso de red entre dominios de las clases WebClient y HTTP en el espacio de nombres System.Net. Las conexiones de red para las clases WebClient y HTTP al sitio u host de origen no requieren una directiva de seguridad. Para obtener más información, vea Restricciones de seguridad de acceso a redes en Silverlight.

Por razones de seguridad, el tiempo de ejecución de Silverlight 2 restringe el acceso a ciertas clases de direcciones URL desde las clases WebClient y HTTP en el espacio de nombres System.Net. El motor en tiempo de ejecución de Silverlight 2 aplica restricciones de acceso similares a otras clases, como las clases MediaElement y Image en el espacio de nombres System.Windows.Controls. El motor en tiempo de ejecución de Silverlight 2 también aplica restricciones de acceso a los archivos de origen XAML y archivos de fuentes basándose en la clase de dirección URL.

Las conexiones afectadas son el acceso a las direcciones URL entre zonas, entre dominios y entre esquemas. Estas restricciones están diseñadas para evitar las amenazas de conexión de red (por ejemplo, las amenazas basadas en una aplicación de Silverlight 2 ejecutada desde un servidor de Internet que obtiene acceso a los recursos de un servidor de la intranet local). Para obtener más información, vea Restricciones de acceso a direcciones URL en Silverlight.

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.

Para obtener una lista de los sistemas operativos y exploradores compatibles con Silverlight, vea Sistemas operativos y exploradores compatibles.

Referencia