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

HttpClient (Clase)

.NET Framework 4.5

Proporciona una clase base para enviar solicitudes HTTP y recibir respuestas HTTP de un recurso identificado por un URI.

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

public class HttpClient : HttpMessageInvoker

El tipo HttpClient expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsHttpClient()Inicializa una nueva instancia de la clase HttpClient.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsHttpClient(HttpMessageHandler)Inicializa una nueva instancia de la clase HttpClient con un controlador específico.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsHttpClient(HttpMessageHandler, Boolean)Inicializa una nueva instancia de la clase HttpClient con un controlador específico.
Arriba

  NombreDescripción
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsBaseAddressObtiene o establece la dirección base de Identificador uniforme de recursos (URI) del recurso de internet utilizado cuando se envían solicitudes.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsDefaultRequestHeadersObtiene los encabezados que se deben enviar con cada solicitud.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsMaxResponseContentBufferSizeObtiene o establece el número máximo de bytes que se van a almacenar en búfer al leer el contenido de la respuesta.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsTimeoutObtiene o establece el número de milisegundos que se va a esperar antes de que se agote el tiempo de espera de la solicitud.
Arriba

  NombreDescripción
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsCancelPendingRequestsCancelar todas las solicitudes pendientes en esta instancia.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsDeleteAsync(String)Envía una solicitud DELETE al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsDeleteAsync(Uri)Envía una solicitud DELETE al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsDeleteAsync(String, CancellationToken)Envía una solicitud DELETE al URI especificado con un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsDeleteAsync(Uri, CancellationToken)Envía una solicitud DELETE al URI especificado con un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsDispose()Libera los recursos no administrados y desecha los recursos administrados que usa HttpMessageInvoker. (Se hereda de HttpMessageInvoker).
Método protegidoCompatible con .NET para aplicaciones de la Tienda WindowsDispose(Boolean)Libera los recursos no administrados que usa el objeto HttpClient y, de forma opcional, desecha los recursos administrados. (Invalida a HttpMessageInvoker.Dispose(Boolean)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(String)Envía una solicitud GET al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(Uri)Envía una solicitud GET al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(String, HttpCompletionOption)Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(String, CancellationToken)Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(Uri, HttpCompletionOption)Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(Uri, CancellationToken)Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(String, HttpCompletionOption, CancellationToken)Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAsync(Uri, HttpCompletionOption, CancellationToken)Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetByteArrayAsync(String)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetByteArrayAsync(Uri)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetStreamAsync(String)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetStreamAsync(Uri)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una secuencia en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetStringAsync(String)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una cadena en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetStringAsync(Uri)Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una cadena en una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPostAsync(String, HttpContent)Envía una solicitud POST al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPostAsync(Uri, HttpContent)Envía una solicitud POST al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPostAsync(String, HttpContent, CancellationToken)Envía una solicitud POST con un token de cancelación como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPostAsync(Uri, HttpContent, CancellationToken)Envía una solicitud POST con un token de cancelación como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPutAsync(String, HttpContent)Envía una solicitud PUT al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPutAsync(Uri, HttpContent)Envía una solicitud PUT al URI especificado como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPutAsync(String, HttpContent, CancellationToken)Envía una solicitud PUT con un token de cancelación como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsPutAsync(Uri, HttpContent, CancellationToken)Envía una solicitud PUT con un token de cancelación como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsSendAsync(HttpRequestMessage)Envía una solicitud HTTP como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsSendAsync(HttpRequestMessage, HttpCompletionOption)Envía una solicitud HTTP como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsSendAsync(HttpRequestMessage, CancellationToken)Envía una solicitud HTTP como una operación asincrónica. (Invalida a HttpMessageInvoker.SendAsync(HttpRequestMessage, CancellationToken)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsSendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)Envía una solicitud HTTP como una operación asincrónica.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

La instancia de clase HttpClient actúa como sesión para enviar solicitudes HTTP. Una instancia HttpClient es una colección de valores aplicados a todas las solicitudes ejecutadas por esa instancia. Además, cada instancia HttpClient utiliza su propio grupo de conexiones, aislando sus solicitudes de las solicitudes ejecutadas por otro HttpClient instancia.

HttpClient también actúa como clase base para clientes HTTP más específicos. Un ejemplo sería un FacebookHttpClient que proporciona los métodos adicionales específicos de un servicio Web de Facebook (método de GetFriends, por ejemplo).

De forma predeterminada, se utilizará HttpWebRequest para enviar solicitudes al servidor. Este comportamiento puede modificarse especificando otro canal de una de las sobrecargas del constructor que toma una instancia HttpMessageHandler como parámetro. Si las características como la autenticación o el almacenamiento en caché se requiere, WebRequestHandler se puede utilizar para configurar valores y instancia se puede pasar al constructor. El controlador devuelto puede pasar a una de las sobrecargas del constructor que tome un parámetro HttpMessageHandler .

Si una aplicación mediante HttpClient y clases relacionadas en el espacio de nombres System.Net.Http se intenta descargar grandes cantidades de datos (50 megabytes o más), la aplicación debe transmitir las descargas y no utilizar el búfer predeterminado. Si se utiliza el búfer predeterminado utilización de memoria de cliente obtendrá muy grande, lo que podría ocasionar rendimiento bastante reducido.

Los métodos siguientes son seguros para subprocesos:

  1. CancelPendingRequests

  2. DeleteAsync

  3. GetAsync

  4. GetByteArrayAsync

  5. GetStreamAsync

  6. GetStringAsync

  7. PostAsync

  8. PutAsync

  9. SendAsync


   static async void Main()
	 {

      // Create a New HttpClient object.
      HttpClient client = new HttpClient();

      // Call asynchronous network methods in a try/catch block to handle exceptions
      try	
      {
         HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
         response.EnsureSuccessStatusCode();
         string responseBody = await response.Content.ReadAsStringAsync();
         // Above three lines can be replaced with new helper method below
         // string responseBody = await client.GetStringAsync(uri);

         Console.WriteLine(responseBody);
      }  
      catch(HttpRequestException e)
      {
         Console.WriteLine("\nException Caught!");	
         Console.WriteLine("Message :{0} ",e.Message);
      }

      // Need to call dispose on the HttpClient object
      // when done using it, so the app doesn't leak resources
      client.Dispose(true);
   }


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows Phone 8.1, Windows Phone 8, 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 static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft