WebClient WebClient WebClient WebClient Class

Definición

Proporciona métodos comunes para enviar y recibir datos de un recurso identificado por un identificador URI.Provides common methods for sending data to and receiving data from a resource identified by a URI.

public ref class WebClient : System::ComponentModel::Component
[System.Runtime.InteropServices.ComVisible(true)]
public class WebClient : System.ComponentModel.Component
type WebClient = class
    inherit Component
Public Class WebClient
Inherits Component
Herencia
Atributos

Ejemplos

En el ejemplo de código siguiente se toma el URI de un recurso, se recupera y se muestra la respuesta.The following code example takes the URI of a resource, retrieves it, and displays the response.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args == nullptr || args->Length == 1 )
   {
      throw gcnew ApplicationException( "Specify the URI of the resource to retrieve." );
   }

   WebClient^ client = gcnew 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[ 1 ] );
   StreamReader^ reader = gcnew StreamReader( data );
   String^ s = reader->ReadToEnd();
   Console::WriteLine( s );
   data->Close();
   reader->Close();
}

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 ();
    }
}
Imports System.Net
Imports System.IO



Public Class Test
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length = 0 Then
            Throw New ApplicationException("Specify the URI of the resource to retrieve.")
        End If
        Dim client As 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;)")
        
        Dim data As Stream = client.OpenRead(args(0))
        Dim reader As New StreamReader(data)
        Dim s As String = reader.ReadToEnd()
        Console.WriteLine(s)
        data.Close()
        reader.Close()
    End Sub
End Class 'Test

Comentarios

Importante

No se recomienda usar la clase para WebClient el nuevo desarrollo.We don't recommend that you use the WebClient class for new development. En su lugar, use System.Net.Http.HttpClient la clase.Instead, use the System.Net.Http.HttpClient class.

La WebClient clase proporciona métodos comunes para enviar o recibir datos de cualquier recurso local, de intranet o de Internet identificado por un URI.The WebClient class provides common methods for sending data to or receiving data from any local, intranet, or Internet resource identified by a URI.

La WebClient clase utiliza la WebRequest clase para proporcionar acceso a los recursos.The WebClient class uses the WebRequest class to provide access to resources. WebClientlas instancias de pueden tener acceso WebRequest a los datos con WebRequest.RegisterPrefix cualquier descendiente registrado con el método.WebClient instances can access data with any WebRequest descendant registered with the WebRequest.RegisterPrefix method.

Nota

De forma predeterminada, la .NET Framework admite los URI que http:comienzan https:con ftp:los identificadores de esquema,, y file: .By default, the .NET Framework supports URIs that begin with http:, https:, ftp:, and file: scheme identifiers.

En la tabla siguiente WebClient se describen los métodos para cargar datos en un recurso.The following table describes WebClient methods for uploading data to a resource.

MétodoMethod DescripciónDescription
OpenWrite Recupera un Stream que se usa para enviar datos al recurso.Retrieves a Stream used to send data to the resource.
OpenWriteAsync Recupera un Stream que se usa para enviar datos al recurso, sin bloquear el subproceso que realiza la llamada.Retrieves a Stream used to send data to the resource, without blocking the calling thread.
UploadData Envía una matriz de bytes al recurso y devuelve Byte una matriz que contiene cualquier respuesta.Sends a byte array to the resource and returns a Byte array containing any response.
UploadDataAsync Envía una Byte matriz al recurso, sin bloquear el subproceso que realiza la llamada.Sends a Byte array to the resource, without blocking the calling thread.
UploadFile Envía un archivo local al recurso y devuelve una Byte matriz que contiene cualquier respuesta.Sends a local file to the resource and returns a Byte array containing any response.
UploadFileAsync Envía un archivo local al recurso, sin bloquear el subproceso que realiza la llamada.Sends a local file to the resource, without blocking the calling thread.
UploadValues Envía un NameValueCollection objeto al recurso y devuelve una Byte matriz que contiene cualquier respuesta.Sends a NameValueCollection to the resource and returns a Byte array containing any response.
UploadValuesAsync Envía un NameValueCollection al recurso y devuelve una Byte matriz que contiene cualquier respuesta, sin bloquear el subproceso que realiza la llamada.Sends a NameValueCollection to the resource and returns a Byte array containing any response, without blocking the calling thread.
UploadString Envía un String al recurso, sin bloquear el subproceso que realiza la llamada.Sends a String to the resource, without blocking the calling thread.
UploadStringAsync Envía un String al recurso, sin bloquear el subproceso que realiza la llamada.Sends a String to the resource, without blocking the calling thread.

En la tabla siguiente WebClient se describen los métodos para descargar datos de un recurso.The following table describes WebClient methods for downloading data from a resource.

MétodoMethod DescripciónDescription
OpenRead Devuelve los datos de un recurso como un Stream.Returns the data from a resource as a Stream.
OpenReadAsync Devuelve los datos de un recurso, sin bloquear el subproceso que realiza la llamada.Returns the data from a resource, without blocking the calling thread.
DownloadData Descarga datos de un recurso y devuelve una Byte matriz.Downloads data from a resource and returns a Byte array.
DownloadDataAsync Descarga datos de un recurso y devuelve una Byte matriz, sin bloquear el subproceso que realiza la llamada.Downloads data from a resource and returns a Byte array, without blocking the calling thread.
DownloadFile Descarga datos de un recurso en un archivo local.Downloads data from a resource to a local file.
DownloadFileAsync Descarga datos de un recurso en un archivo local, sin bloquear el subproceso que realiza la llamada.Downloads data from a resource to a local file, without blocking the calling thread.
DownloadString Descarga un String de un recurso y devuelve un String.Downloads a String from a resource and returns a String.
DownloadStringAsync Descarga un String desde un recurso, sin bloquear el subproceso que realiza la llamada.Downloads a String from a resource, without blocking the calling thread.

Puede usar el CancelAsync método para cancelar las operaciones asincrónicas que no se han completado.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

De WebClient forma predeterminada, una instancia no envía encabezados HTTP opcionales.A WebClient instance does not send optional HTTP headers by default. Si la solicitud requiere un encabezado opcional, debe agregar el encabezado a la Headers colección.If your request requires an optional header, you must add the header to the Headers collection. Por ejemplo, para conservar las consultas en la respuesta, debe agregar un encabezado User-Agent.For example, to retain queries in the response, you must add a user-agent header. Además, los servidores pueden devolver 500 (error interno del servidor) si falta el encabezado de agente de usuario.Also, servers may return 500 (Internal Server Error) if the user agent header is missing.

AllowAutoRedirectestá establecido true en en WebClient instancias de.AllowAutoRedirect is set to true in WebClient instances.

Notas a los desarrolladores de herederos

Las clases derivadas deben llamar a la implementación WebClient de la clase base de para asegurarse de que la clase derivada funciona según lo esperado.Derived classes should call the base class implementation of WebClient to ensure the derived class works as expected.

Constructores

WebClient() WebClient() WebClient() WebClient()

Inicializa una nueva instancia de la clase WebClient.Initializes a new instance of the WebClient class.

Propiedades

AllowReadStreamBuffering AllowReadStreamBuffering AllowReadStreamBuffering AllowReadStreamBuffering

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.Gets or sets a value that indicates whether to buffer the data read from the Internet resource for a WebClient instance.

AllowWriteStreamBuffering AllowWriteStreamBuffering AllowWriteStreamBuffering AllowWriteStreamBuffering

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.Gets or sets a value that indicates whether to buffer the data written to the Internet resource for a WebClient instance.

BaseAddress BaseAddress BaseAddress BaseAddress

Obtiene o establece el URI de base para las solicitudes realizadas por un WebClient.Gets or sets the base URI for requests made by a WebClient.

CachePolicy CachePolicy CachePolicy CachePolicy

Obtiene o establece la directiva de caché de la aplicación para los recursos obtenidos por esta instancia de WebClient mediante objetos WebRequest.Gets or sets the application's cache policy for any resources obtained by this WebClient instance using WebRequest objects.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Credentials Credentials Credentials Credentials

Obtiene o establece las credenciales de red que se envían al host y se utilizan para autenticar la solicitud.Gets or sets the network credentials that are sent to the host and used to authenticate the request.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Encoding Encoding Encoding Encoding

Obtiene o establece el objeto Encoding usado para cargar y descargar cadenas.Gets or sets the Encoding used to upload and download strings.

Events Events Events Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Headers Headers Headers Headers

Obtiene o establece una colección de pares de nombre y valor de encabezado asociados a la solicitud.Gets or sets a collection of header name/value pairs associated with the request.

IsBusy IsBusy IsBusy IsBusy

Determina si hay una solicitud Web en curso.Gets whether a Web request is in progress.

Proxy Proxy Proxy Proxy

Obtiene o establece el servidor proxy utilizado por este objeto WebClient.Gets or sets the proxy used by this WebClient object.

QueryString QueryString QueryString QueryString

Obtiene o establece una colección de pares de nombre y valor de consulta asociados a la solicitud.Gets or sets a collection of query name/value pairs associated with the request.

ResponseHeaders ResponseHeaders ResponseHeaders ResponseHeaders

Obtiene una colección de pares de nombre/valor de encabezado asociados a la respuesta.Gets a collection of header name/value pairs associated with the response.

Site Site Site Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Métodos

CancelAsync() CancelAsync() CancelAsync() CancelAsync()

Cancela una operación asincrónica pendiente.Cancels a pending asynchronous operation.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
DownloadData(String) DownloadData(String) DownloadData(String) DownloadData(String)

Descarga el recurso como una matriz de Byte desde el URI especificado.Downloads the resource as a Byte array from the URI specified.

DownloadData(Uri) DownloadData(Uri) DownloadData(Uri) DownloadData(Uri)

Descarga el recurso como una matriz de Byte desde el URI especificado.Downloads the resource as a Byte array from the URI specified.

DownloadDataAsync(Uri) DownloadDataAsync(Uri) DownloadDataAsync(Uri) DownloadDataAsync(Uri)

Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica.Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object)

Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica.Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataTaskAsync(String) DownloadDataTaskAsync(String) DownloadDataTaskAsync(String) DownloadDataTaskAsync(String)

Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri)

Descarga el recurso como una matriz de Byte desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String)

Descarga el recurso con el URI especificado en un archivo local.Downloads the resource with the specified URI to a local file.

DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String)

Descarga el recurso con el URI especificado en un archivo local.Downloads the resource with the specified URI to a local file.

DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String)

Descarga en un archivo local el recurso con el URI especificado.Downloads, to a local file, the resource with the specified URI. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object)

Descarga en un archivo local el recurso con el URI especificado.Downloads, to a local file, the resource with the specified URI. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String)

Descarga el recurso especificado en un archivo local como operación asincrónica utilizando un objeto de tarea.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String)

Descarga el recurso especificado en un archivo local como operación asincrónica utilizando un objeto de tarea.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

Descarga el recurso solicitado como String.Downloads the requested resource as a String. El recurso para descargar se especifica como una String que contiene el URI.The resource to download is specified as a String containing the URI.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

Descarga el recurso solicitado como String.Downloads the requested resource as a String. El recurso que se descarga se especifica como un Uri.The resource to download is specified as a Uri.

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Descarga el recurso especificado como Uri.Downloads the resource specified as a Uri. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

Descarga la cadena especificada en el recurso especificado.Downloads the specified string to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String)

Descarga el recurso como un String desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.Downloads the resource as a String from the URI specified as an asynchronous operation using a task object.

DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri)

Descarga el recurso como un String desde el URI especificado como una operación asincrónica utilizando un objeto de tarea.Downloads the resource as a String from the URI specified as an asynchronous operation using a task object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri)

Devuelve un objeto WebRequest para el recurso especificado.Returns a WebRequest object for the specified resource.

GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest)

Devuelve el objeto WebResponse correspondiente al objeto WebRequest especificado.Returns the WebResponse for the specified WebRequest.

GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult)

Devuelve el objeto WebResponse correspondiente al objeto WebRequest especificado utilizando el objeto IAsyncResult especificado.Returns the WebResponse for the specified WebRequest using the specified IAsyncResult.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs)

Genera el evento DownloadDataCompleted.Raises the DownloadDataCompleted event.

OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs)

Genera el evento DownloadFileCompleted.Raises the DownloadFileCompleted event.

OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs)

Genera el evento DownloadProgressChanged.Raises the DownloadProgressChanged event.

OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs)

Genera el evento DownloadStringCompleted.Raises the DownloadStringCompleted event.

OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs)

Genera el evento OpenReadCompleted.Raises the OpenReadCompleted event.

OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs)

Genera el evento OpenWriteCompleted.Raises the OpenWriteCompleted event.

OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs)

Genera el evento UploadDataCompleted.Raises the UploadDataCompleted event.

OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs)

Genera el evento UploadFileCompleted.Raises the UploadFileCompleted event.

OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs)

Genera el evento UploadProgressChanged.Raises the UploadProgressChanged event.

OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs)

Genera el evento UploadStringCompleted.Raises the UploadStringCompleted event.

OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs)

Genera el evento UploadValuesCompleted.Raises the UploadValuesCompleted event.

OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs)

Genera el evento WriteStreamClosed.Raises the WriteStreamClosed event.

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

Abre una secuencia legible de los datos descargados desde un recurso con el URI especificado como String.Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Abre una secuencia legible de los datos descargados desde un recurso con el URI especificado como Uri.Opens a readable stream for the data downloaded from a resource with the URI specified as a Uri

OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri)

Abre una secuencia legible que contiene el recurso especificado.Opens a readable stream containing the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object)

Abre una secuencia legible que contiene el recurso especificado.Opens a readable stream containing the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

Abre una secuencia legible que contiene el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Abre una secuencia para escribir datos en el recurso especificado.Opens a stream for writing data to the specified resource.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado.Opens a stream for writing data to the specified resource, using the specified method.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Abre una secuencia para escribir datos en el recurso especificado.Opens a stream for writing data to the specified resource.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado.Opens a stream for writing data to the specified resource, by using the specified method.

OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri)

Abre una secuencia para escribir datos en el recurso especificado.Opens a stream for writing data to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String)

Abre una secuencia para escribir datos en el recurso especificado.Opens a stream for writing data to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object)

Abre una secuencia para escribir datos en el recurso especificado mediante el método especificado.Opens a stream for writing data to the specified resource, using the specified method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String)

Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String)

Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri)

Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String)

Abra una secuencia para escribir datos en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

ToString() ToString() ToString() ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Inherited from Component)
UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[])

Carga un búfer de datos en un recurso identificado por un URI.Uploads a data buffer to a resource identified by a URI.

UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[])

Carga un búfer de datos en el recurso especificado, utilizando el método especificado.Uploads a data buffer to the specified resource, using the specified method.

UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[])

Carga un búfer de datos en un recurso identificado por un URI.Uploads a data buffer to a resource identified by a URI.

UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[])

Carga un búfer de datos en el recurso especificado, utilizando el método especificado.Uploads a data buffer to the specified resource, using the specified method.

UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[])

Carga un búfer de datos en un recurso identificado mediante un URI utilizando el método POST.Uploads a data buffer to a resource identified by a URI, using the POST method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[])

Carga un búfer de datos en un recurso identificado mediante un URI utilizando el método POST.Uploads a data buffer to a resource identified by a URI, using the specified method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(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.Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token.

UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(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.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(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.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(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.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(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.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

Carga el archivo local especificado en un recurso con el URI especificado.Uploads the specified local file to a resource with the specified URI.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

Carga el archivo local especificado en el recurso especificado mediante el método especificado.Uploads the specified local file to the specified resource, using the specified method.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

Carga el archivo local especificado en un recurso con el URI especificado.Uploads the specified local file to a resource with the specified URI.

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

Carga el archivo local especificado en el recurso especificado mediante el método especificado.Uploads the specified local file to the specified resource, using the specified method.

UploadFileAsync(Uri, String) UploadFileAsync(Uri, String) UploadFileAsync(Uri, String) UploadFileAsync(Uri, String)

Carga el archivo local especificado en el recurso especificado mediante el método POST.Uploads the specified local file to the specified resource, using the POST method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String)

Carga el archivo local especificado en el recurso especificado mediante el método POST.Uploads the specified local file to the specified resource, using the POST method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object)

Carga el archivo local especificado en el recurso especificado mediante el método POST.Uploads the specified local file to the specified resource, using the POST method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String)

Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String)

Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String)

Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String)

Carga el archivo local especificado en un recurso como operación asincrónica utilizando un objeto de tarea.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

Carga la cadena especificada en el recurso especificado mediante el método POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

Carga la cadena especificada en el recurso especificado mediante el método especificado.Uploads the specified string to the specified resource, using the specified method.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

Carga la cadena especificada en el recurso especificado mediante el método POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

Carga la cadena especificada en el recurso especificado mediante el método especificado.Uploads the specified string to the specified resource, using the specified method.

UploadStringAsync(Uri, String) UploadStringAsync(Uri, String) UploadStringAsync(Uri, String) UploadStringAsync(Uri, String)

Carga la cadena especificada en el recurso especificado.Uploads the specified string to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String)

Carga la cadena especificada en el recurso especificado.Uploads the specified string to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object)

Carga la cadena especificada en el recurso especificado.Uploads the specified string to the specified resource. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String)

Carga la cadena especificada en el recurso especificado como una operación asincrónica utilizando un objeto de tarea.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection)

Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado.Uploads the specified name/value collection to the resource identified by the specified URI.

UploadValues(String, String, NameValueCollection) UploadValues(String, String, NameValueCollection) UploadValues(String, String, NameValueCollection) UploadValues(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.Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection)

Carga la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado.Uploads the specified name/value collection to the resource identified by the specified URI.

UploadValues(Uri, String, NameValueCollection) UploadValues(Uri, String, NameValueCollection) UploadValues(Uri, String, NameValueCollection) UploadValues(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.Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection)

Carga los datos de la colección de nombres y valores especificada en el recurso identificado mediante el URI especificado.Uploads the data in the specified name/value collection to the resource identified by the specified URI. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(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.Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. Este método no bloquea el subproceso que realiza la llamada.This method does not block the calling thread.

UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(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.Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. 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.This method does not block the calling thread, and allows the caller to pass an object to the method that is invoked when the operation completes.

UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(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.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(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.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(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.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(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.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

Eventos

Disposed Disposed Disposed Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DownloadDataCompleted DownloadDataCompleted DownloadDataCompleted DownloadDataCompleted

Se produce cuando finaliza una operación de descarga de datos asincrónica.Occurs when an asynchronous data download operation completes.

DownloadFileCompleted DownloadFileCompleted DownloadFileCompleted DownloadFileCompleted

Se produce cuando finaliza una operación de descarga de archivo asincrónica.Occurs when an asynchronous file download operation completes.

DownloadProgressChanged DownloadProgressChanged DownloadProgressChanged DownloadProgressChanged

Se produce cuando una operación de descarga asincrónica transfiere correctamente una parte o la totalidad de los datos.Occurs when an asynchronous download operation successfully transfers some or all of the data.

DownloadStringCompleted DownloadStringCompleted DownloadStringCompleted DownloadStringCompleted

Se produce cuando finaliza una operación de descarga de recursos asincrónica.Occurs when an asynchronous resource-download operation completes.

OpenReadCompleted OpenReadCompleted OpenReadCompleted OpenReadCompleted

Se produce cuando finaliza una operación asincrónica para abrir una secuencia que contiene un recurso.Occurs when an asynchronous operation to open a stream containing a resource completes.

OpenWriteCompleted OpenWriteCompleted OpenWriteCompleted OpenWriteCompleted

Se produce cuando se completa una operación asincrónica para abrir una secuencia para escribir datos en un recurso.Occurs when an asynchronous operation to open a stream to write data to a resource completes.

UploadDataCompleted UploadDataCompleted UploadDataCompleted UploadDataCompleted

Se produce cuando finaliza una operación de carga de datos asincrónica.Occurs when an asynchronous data-upload operation completes.

UploadFileCompleted UploadFileCompleted UploadFileCompleted UploadFileCompleted

Se produce cuando finaliza una operación de carga de archivos asincrónica.Occurs when an asynchronous file-upload operation completes.

UploadProgressChanged UploadProgressChanged UploadProgressChanged UploadProgressChanged

Se produce cuando una operación de carga asincrónica transfiere correctamente una parte o la totalidad de los datos.Occurs when an asynchronous upload operation successfully transfers some or all of the data.

UploadStringCompleted UploadStringCompleted UploadStringCompleted UploadStringCompleted

Se produce cuando se completa una operación de carga de cadenas asincrónica.Occurs when an asynchronous string-upload operation completes.

UploadValuesCompleted UploadValuesCompleted UploadValuesCompleted UploadValuesCompleted

Se produce cuando finaliza una operación de carga asincrónica de una colección de nombres y valores.Occurs when an asynchronous upload of a name/value collection completes.

WriteStreamClosed WriteStreamClosed WriteStreamClosed WriteStreamClosed

Se produce cuando se cierra una operación asincrónica para escribir datos en un recurso usando una secuencia de escritura.Occurs when an asynchronous operation to write data to a resource using a write stream is closed.

Seguridad

WebPermission
Para tener acceso al URI solicitado o a cualquier URI al que se redirige la solicitud.to access the requested URI or any URI that the request is redirected to. Enumeración asociada: Connect.Associated enumeration: Connect.

Se aplica a

Consulte también: