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
Personas que lo han encontrado útil: 1 de 2 - Valorar este tema

HttpWebRequest (Clase)

Proporciona una implementación específica de HTTP de la clase WebRequest.

Espacio de nombres:  System.Net
Ensamblado:  System (en System.dll)
[SerializableAttribute]
public class HttpWebRequest : WebRequest, 
	ISerializable

El tipo HttpWebRequest expone los siguientes miembros.

  NombreDescripción
Método públicoHttpWebRequest() Obsoleto. Inicializa una nueva instancia de la clase HttpWebRequest.
Método protegidoHttpWebRequest(SerializationInfo, StreamingContext) Obsoleto. Inicializa una nueva instancia de la clase HttpWebRequest a partir de las instancias especificadas de las clases SerializationInfo y StreamingContext.
Arriba
  NombreDescripción
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAcceptObtiene o establece el valor del encabezado HTTP Accept.
Propiedad públicaAddressObtiene el identificador URI del recurso de Internet que respondió realmente a la solicitud.
Propiedad públicaAllowAutoRedirectObtiene o establece un valor que indica si la solicitud debe seguir las respuestas de redirección.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsAllowReadStreamBufferingObtiene o establece un valor que indica si los datos recibidos del recurso de Internet deben almacenarse en el búfer.
Propiedad públicaAllowWriteStreamBufferingObtiene o establece un valor que indica si se deben almacenar en el búfer los datos enviados al recurso de Internet.
Propiedad públicaAuthenticationLevelObtiene o establece valores que indican el nivel de autenticación y de suplantación utilizados para esta solicitud. (Se hereda de WebRequest).
Propiedad públicaAutomaticDecompressionObtiene o establece el tipo de descompresión que se utiliza.
Propiedad públicaCachePolicyObtiene o establece la directiva de caché para esta solicitud. (Se hereda de WebRequest).
Propiedad públicaClientCertificatesObtiene o establece la colección de certificados de seguridad asociados a esta solicitud.
Propiedad públicaConnectionObtiene o establece el valor del encabezado HTTP Connection.
Propiedad públicaConnectionGroupNameObtiene o establece el nombre del grupo de conexiones para la solicitud. (Invalida a WebRequest.ConnectionGroupName).
Propiedad públicaContentLengthObtiene o establece el encabezado HTTP Content-length. (Invalida a WebRequest.ContentLength).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContentTypeObtiene o establece el valor del encabezado HTTP Content-type. (Invalida a WebRequest.ContentType).
Propiedad públicaContinueDelegateObtiene o establece el método de delegado al que se llama cuando se recibe una respuesta HTTP 100-continue desde el recurso de Internet.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsContinueTimeoutObtiene o establece el tiempo de espera, en milisegundos, para esperar hasta que se reciba 100-Continue del servidor.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCookieContainerObtiene o establece las cookies asociadas a la solicitud.
Propiedad públicaCreatorInstance Obsoleto. Cuando se reemplaza en una clase descendiente, obtiene el objeto generador derivado de la clase IWebRequestCreate usada para crear la instancia de WebRequest para efectuar la solicitud al URI especificado. (Se hereda de WebRequest).
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsCredentialsObtiene o establece la información de autenticación para la solicitud. (Invalida a WebRequest.Credentials).
Propiedad públicaDateObtiene o establece el valor del encabezado HTTP Date que se va a usar en una solicitud HTTP.
Propiedad públicaMiembro estáticoDefaultCachePolicyObtiene o establece la directiva de caché predeterminada para esta solicitud.
Propiedad públicaMiembro estáticoDefaultMaximumErrorResponseLengthObtiene o establece la longitud máxima predeterminada de una respuesta de error de HTTP.
Propiedad públicaMiembro estáticoDefaultMaximumResponseHeadersLengthObtiene o establece el valor predeterminado de la propiedad MaximumResponseHeadersLength.
Propiedad públicaExpectObtiene o establece el valor del encabezado HTTP Expect.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsHaveResponseObtiene un valor que indica si se ha recibido una respuesta de un recurso de Internet.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsHeadersEspecifica una colección de los pares nombre/valor que componen los encabezados HTTP. (Invalida a WebRequest.Headers).
Propiedad públicaHostObtiene o establece el valor del encabezado Host que se va a usar en una solicitud HTTP independiente del identificador URI de la solicitud.
Propiedad públicaIfModifiedSinceObtiene o establece el valor del encabezado HTTP If-Modified-Since.
Propiedad públicaImpersonationLevelObtiene o establece el nivel de suplantación para la solicitud actual. (Se hereda de WebRequest).
Propiedad públicaKeepAliveObtiene o establece un valor que indica si se debe establecer una conexión persistente en el recurso de Internet.
Propiedad públicaMaximumAutomaticRedirectionsObtiene o establece el número máximo de redirecciones que seguirá la solicitud.
Propiedad públicaMaximumResponseHeadersLengthObtiene o establece la longitud máxima permitida de los encabezados de respuesta.
Propiedad públicaMediaTypeObtiene o establece el tipo del medio de la solicitud.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMethodObtiene o establece el método para la solicitud. (Invalida a WebRequest.Method).
Propiedad públicaPipelinedObtiene o establece un valor que indica si se debe canalizar la solicitud en el recurso de Internet.
Propiedad públicaPreAuthenticateObtiene o establece un valor que indica si se envía un encabezado de autorización con la solicitud. (Invalida a WebRequest.PreAuthenticate).
Propiedad públicaProtocolVersionObtiene o establece la versión de HTTP que se va a utilizar para la solicitud.
Propiedad públicaProxyObtiene o establece la información de proxy para la solicitud. (Invalida a WebRequest.Proxy).
Propiedad públicaReadWriteTimeoutObtiene o establece un tiempo de espera, en milisegundos, al leer o escribir una secuencia.
Propiedad públicaRefererObtiene o establece el valor del encabezado HTTP Referer.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsRequestUriObtiene el identificador URI original de la solicitud. (Invalida a WebRequest.RequestUri).
Propiedad públicaSendChunkedObtiene o establece un valor que indica si se deben enviar los datos segmentados al recurso de Internet.
Propiedad públicaServerCertificateValidationCallbackObtiene o establece una función de devolución de llamada para validar el certificado de servidor.
Propiedad públicaServicePointObtiene el punto de servicio que se va a utilizar para la solicitud.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsSupportsCookieContainerObtiene un valor que indica si la solicitud admite un objeto CookieContainer.
Propiedad públicaTimeoutObtiene o establece el valor de tiempo de espera, en milisegundos, para los métodos GetResponse y GetRequestStream. (Invalida a WebRequest.Timeout).
Propiedad públicaTransferEncodingObtiene o establece el valor del encabezado HTTP Transfer-encoding.
Propiedad públicaUnsafeAuthenticatedConnectionSharingObtiene o establece un valor que indica si se permite el uso compartido de las conexiones de alta velocidad autenticadas por NTLM.
Propiedad públicaCompatible con .NET para aplicaciones de la Tienda WindowsUseDefaultCredentialsObtiene o establece un valor Boolean que controla si se envían las credenciales predeterminadas con las solicitudes. (Invalida a WebRequest.UseDefaultCredentials).
Propiedad públicaUserAgentObtiene o establece el valor del encabezado HTTP User-agent.
Arriba
  NombreDescripción
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAbortCancela una solicitud de un recurso de Internet. (Invalida a WebRequest.Abort()).
Método públicoAddRange(Int32)Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.
Método públicoAddRange(Int64)Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.
Método públicoAddRange(Int32, Int32)Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.
Método públicoAddRange(Int64, Int64)Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.
Método públicoAddRange(String, Int32)Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.
Método públicoAddRange(String, Int64)Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.
Método públicoAddRange(String, Int32, Int32)Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.
Método públicoAddRange(String, Int64, Int64)Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsBeginGetRequestStreamInicia una solicitud asincrónica de un objeto Stream que se va a utilizar para escribir datos. (Invalida a WebRequest.BeginGetRequestStream(AsyncCallback, Object)).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsBeginGetResponseComienza una solicitud asincrónica de un recurso de Internet. (Invalida a WebRequest.BeginGetResponse(AsyncCallback, Object)).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEndGetRequestStream(IAsyncResult)Finaliza una solicitud asincrónica para utilizar un objeto Stream para escribir datos. (Invalida a WebRequest.EndGetRequestStream(IAsyncResult)).
Método públicoEndGetRequestStream(IAsyncResult, TransportContext)Finaliza una solicitud asincrónica de un objeto Stream que se va a usar para escribir los datos y genera el objeto TransportContext asociado a la secuencia.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEndGetResponseTermina una solicitud asincrónica de un recurso de Internet. (Invalida a WebRequest.EndGetResponse(IAsyncResult)).
Método públicoCompatible con Biblioteca de clases portableCompatible 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 Biblioteca de clases portableCompatible 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 Biblioteca de clases portableCompatible 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úblicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetObjectDataInfraestructura. Rellena SerializationInfo con los datos necesarios para serializar el objeto de destino. (Invalida a WebRequest.GetObjectData(SerializationInfo, StreamingContext)).
Método públicoGetRequestStream()Obtiene un objeto Stream que se utilizará para escribir los datos de la solicitud. (Invalida a WebRequest.GetRequestStream()).
Método públicoGetRequestStream(TransportContext)Obtiene un objeto Stream que se va a usar para escribir los datos de la solicitud y genera el objeto TransportContext asociado a la secuencia.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetRequestStreamAsyncCuando se invalida en una clase descendiente, devuelve un objeto Stream para escribir datos en el recurso de Internet como una operación asincrónica. (Se hereda de WebRequest).
Método públicoGetResponseDevuelve una respuesta desde un recurso de Internet. (Invalida a WebRequest.GetResponse()).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetResponseAsyncCuando se invalida en una clase descendiente, devuelve una respuesta a una solicitud de Internet como una operación asincrónica. (Se hereda de WebRequest).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba
  NombreDescripción
Implementación explícita de interfacesMétodo privadoISerializable.GetObjectDataInfraestructura. Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.
Arriba

La clase HttpWebRequest hace que se admitan las propiedades y los métodos definidos en WebRequest y que las propiedades y los métodos adicionales permitan al usuario interactuar directamente con servidores que utilicen HTTP.

No utilice el constructor HttpWebRequest. Utilice el método WebRequest.Create para inicializar nuevos objetos HttpWebRequest. Si el esquema para el identificador URI es http:// o https://, Create devuelve un objeto HttpWebRequest.

El método GetResponse realiza una solicitud sincrónica al recurso especificado en la propiedad RequestUri y devuelve un objeto HttpWebResponse con la respuesta. Para realizar una solicitud asincrónica al recurso, utilice los métodos BeginGetResponse y EndGetResponse.

Si desea enviar datos al recurso, el método GetRequestStream devuelve un objeto Stream que se utiliza para enviar datos. Los métodos BeginGetRequestStream y EndGetRequestStream proporcionan acceso asincrónico al flujo de datos de envío.

Para la autenticación del cliente con HttpWebRequest, se debe instalar el certificado del cliente en el almacén de certificados My del usuario actual.

La clase HttpWebRequest produce una excepción WebException cuando se producen errores en el acceso a un recurso. La propiedad WebException.Status contiene un valor WebExceptionStatus que indica el origen del error. Si WebException.Status es WebExceptionStatus.ProtocolError, la propiedad Response contiene el valor de HttpWebResponse recibido del recurso.

HttpWebRequest expone valores de encabezado HTTP comunes enviados al recurso de Internet como propiedades. Dichos valores se encuentran establecidos por métodos o por el sistema. En la tabla siguiente se presenta una lista completa. Es posible establecer otros encabezados en la propiedad Headers como pares nombre/valor. Tenga en cuenta que los servidores y cachés pueden cambiar o agregar encabezados durante la solicitud.

En la tabla siguiente se muestran los encabezados HTTP establecidos por propiedades o métodos, o por el sistema.

Encabezado

Establecido por

Accept

La propiedad Accept.

Conexión

Las propiedades Connection y KeepAlive.

Content-Length

La propiedad ContentLength.

Content-Type

La propiedad ContentType.

Expect

La propiedad Expect.

Fecha

El sistema con la fecha actual.

Host

El sistema con la información de host actual.

If-Modified-Since

La propiedad IfModifiedSince.

Intervalo

El método AddRange.

Referer

La propiedad Referer.

Transfer-Encoding

Establecido por la propiedad TransferEncoding (la propiedad SendChunked debe ser true).

User-Agent

La propiedad UserAgent.

NotaNota

HttpWebRequest se registra automáticamente. No es necesario llamar al método RegisterPrefix para registrar System.Net.HttpWebRequest antes de usar identificadores URI que comiencen con http:// o https://.

El archivo de configuración de la aplicación o el equipo local puede especificar que se use un proxy predeterminado. Si se especifica la propiedad Proxy, la configuración de proxy de la propiedad Proxy invalidará el archivo de configuración de la aplicación o el equipo local y la instancia de HttpWebRequest usará la configuración de proxy especificada. Si no se especifica ningún proxy en el archivo de configuración y tampoco se especifica la propiedad Proxy, la clase HttpWebRequest usará la configuración de proxy heredada de Internet Explorer en el equipo local. Si no hay ninguna configuración de proxy en Internet Explorer, la solicitud se enviará directamente al servidor.

La clase HttpWebRequest analiza una lista de omisión de proxy con caracteres comodín heredada de Internet Explorer de distinto modo en que Internet Explorer analiza directamente la lista de omisión. Por ejemplo, la clase HttpWebRequest analiza una lista de omisión "nt*" de Internet Explorer como una expresión regular "nt.$". Este comportamiento difiere del comportamiento nativo de Internet Explorer. De modo que una dirección URL "http://intxxxxx" omitiría el proxy utilizando la clase HttpWebRequest, pero no omitiría el proxy utilizando Internet Explorer.

NotaNota

El marco de trabajo almacena en caché las sesiones de SSL a medida que se crean, e intenta reutilizar una sesión almacenada en memoria caché para una nueva solicitud, si es posible. Si intenta reutilizar una sesión de SSL, el Framework utiliza el primer elemento de ClientCertificates (si existe) o intenta reutilizar una sesión anónima si el valor de ClientCertificates está vacío.

NotaNota

Por razones de seguridad, de manera predeterminada las cookies están deshabilitadas. Si desea utilizar cookies, habilítelas mediante la propiedad CookieContainer.

En el ejemplo de código siguiente se crea un objeto HttpWebRequest para el identificador URI http://www.contoso.com/.



HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");



.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8
  • WebPermission 

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

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

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.