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 WebRequest

 

Publicado: octubre de 2016

Realiza una solicitud a un identificador uniforme de recursos (URI). Esta es una clase abstract.

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


[SerializableAttribute]
public abstract class WebRequest : MarshalByRefObject, ISerializable

NombreDescripción
System_CAPS_protmethodWebRequest()

Inicializa una nueva instancia de la clase WebRequest.

System_CAPS_protmethodWebRequest(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase WebRequest desde las instancias especificadas de las clases SerializationInfo y StreamingContext.

NombreDescripción
System_CAPS_pubpropertyAuthenticationLevel

Obtiene o establece valores que indican el nivel de autenticación y de suplantación utilizados para esta solicitud.

System_CAPS_pubpropertyCachePolicy

Obtiene o establece la directiva de caché para esta solicitud.

System_CAPS_pubpropertyConnectionGroupName

Cuando se reemplaza en una clase descendiente, obtiene o establece el nombre del grupo de conexiones para la solicitud.

System_CAPS_pubpropertyContentLength

Cuando se reemplaza en una clase descendiente, obtiene o establece la longitud del contenido de los datos solicitados que se envían.

System_CAPS_pubpropertyContentType

Cuando se reemplaza en una clase descendiente, obtiene o establece el tipo de contenido de los datos solicitados que se envían.

System_CAPS_pubpropertyCreatorInstance

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.

System_CAPS_pubpropertyCredentials

Cuando se reemplaza en una clase descendiente, obtiene o establece las credenciales de red utilizadas para autenticar la solicitud con el recurso de Internet.

System_CAPS_pubpropertySystem_CAPS_staticDefaultCachePolicy

Obtiene o establece la directiva de caché predeterminada para esta solicitud.

System_CAPS_pubpropertySystem_CAPS_staticDefaultWebProxy

Obtiene o establece el proxy HTTP global.

System_CAPS_pubpropertyHeaders

Cuando se reemplaza en una clase descendiente, obtiene o establece la colección de pares de nombre/valor de encabezado asociados a la solicitud.

System_CAPS_pubpropertyImpersonationLevel

Obtiene o establece el nivel de suplantación para la solicitud actual.

System_CAPS_pubpropertyMethod

Cuando se reemplaza en una clase descendiente, obtiene o establece el método de protocolo que se va a utilizar en esta solicitud.

System_CAPS_pubpropertyPreAuthenticate

Cuando se reemplaza en una clase descendiente, indica si se va a realizar la autenticación previa de la solicitud.

System_CAPS_pubpropertyProxy

Cuando se reemplaza en una clase descendiente, obtiene o establece el proxy de red que se va a utilizar para tener acceso a este recurso de Internet.

System_CAPS_pubpropertyRequestUri

Cuando se reemplaza en una clase descendiente, obtiene el identificador URI del recurso de Internet asociado a la solicitud.

System_CAPS_pubpropertyTimeout

Obtiene o establece el tiempo, en milisegundos, antes de que se agoten los tiempos de espera de la solicitud.

System_CAPS_pubpropertyUseDefaultCredentials

Cuando se reemplaza en una clase descendiente, obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.

NombreDescripción
System_CAPS_pubmethodAbort()

Anula la solicitud

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

Cuando se reemplaza en una clase descendiente, proporciona una versión asincrónica del método GetRequestStream.

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

Cuando se reemplaza en una clase descendiente, comienza una solicitud asincrónica de un recurso de Internet.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri)

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreateDefault(Uri)

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(String)

Inicializa una nueva instancia de HttpWebRequest para la cadena de URI especificada.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(Uri)

Inicializa una nueva instancia de HttpWebRequest para el URI especificado.

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

Cuando se reemplaza en una clase descendiente, devuelve Stream para escribir datos en el recurso de Internet.

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

Cuando se reemplaza en una clase descendiente, devuelve WebResponse.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

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_protmethodGetObjectData(SerializationInfo, StreamingContext)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.

System_CAPS_pubmethodGetRequestStream()

Cuando se reemplaza en una clase descendiente, devuelve Stream para escribir datos en el recurso de Internet.

System_CAPS_pubmethodGetRequestStreamAsync()

Cuando se invalida en una clase descendiente, devuelve un objeto Stream para escribir datos en el recurso de Internet como una operación asincrónica.

System_CAPS_pubmethodGetResponse()

Cuando se reemplaza en una clase descendiente, devuelve una respuesta a una solicitud de Internet.

System_CAPS_pubmethodGetResponseAsync()

Cuando se invalida en una clase descendiente, devuelve una respuesta a una solicitud de Internet como una operación asincrónica.

System_CAPS_pubmethodSystem_CAPS_staticGetSystemWebProxy()

Devuelve un servidor proxy configurado con la configuración de Internet Explorer del usuario actualmente suplantado.

System_CAPS_pubmethodGetType()

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

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 actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodSystem_CAPS_staticRegisterPortableWebRequestCreator(IWebRequestCreate)

Obsoleto. Registra un objeto IWebRequestCreate.

System_CAPS_pubmethodSystem_CAPS_staticRegisterPrefix(String, IWebRequestCreate)

Registra un descendiente WebRequest para el identificador URI especificado.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Cuando se reemplaza en una clase descendiente, rellena una instancia de SerializationInfo con los datos necesarios para serializar el objeto WebRequest.

WebRequest es el abstract la clase base para el modelo de solicitud/respuesta de .NET Framework para tener acceso a datos desde Internet. Una aplicación que utiliza el modelo de solicitud/respuesta puede solicitar datos de Internet de una manera independiente de los protocolos, donde la aplicación trabaja con instancias de la WebRequest clase mientras que las clases descendientes específicas del protocolo efectúan los detalles de la solicitud.

Las solicitudes se envían desde una aplicación a un URI concreto, como una página Web en un servidor. El URI determina la clase descendiente adecuada para crear a partir de una lista de WebRequest descendientes registrado para la aplicación. WebRequest descendientes suelen registrarse para controlar un protocolo específico, como HTTP o FTP, pero se pueden registrar para controlar una solicitud a un servidor específico o una ruta de acceso en un servidor.

La clase WebRequest inicia un WebException cuando se producen errores al tener acceso a un recurso de Internet. El Status propiedad es uno de los WebExceptionStatus valores que indica el origen del error. Cuando Status es WebExceptionStatus.ProtocolError, el Response propiedad contiene el WebResponse recibidos del recurso de Internet.

Dado que la clase WebRequest es una clase abstract, el comportamiento real de las instancias WebRequest en tiempo de ejecución viene determinado por la clase descendiente devuelta por el método Create. Para obtener más información acerca de los valores predeterminados y las excepciones, consulte la documentación de las clases descendientes, como HttpWebRequest y FileWebRequest.

System_CAPS_noteNota

Utilice la Create método para inicializar nuevas WebRequest instancias. No utilice la WebRequest constructor.

System_CAPS_noteNota

Si la aplicación que crea el objeto WebRequest se ejecuta con las credenciales de un usuario Normal, la aplicación no podrá obtener acceso a los certificados instalados en el almacén del equipo local a menos que el usuario tenga permiso explícitamente para hacerlo.

Notas para desarrolladores de herederos:

Al heredar de WebRequest, debe reemplazar los miembros siguientes: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream, BeginGetRequestStream, EndGetRequestStream, GetResponse, BeginGetResponse, y EndGetResponse. Además, debe proporcionar una implementación de la IWebRequestCreate interfaz, que define la Create método se utiliza cuando se llama a Create. Debe registrar la clase que implementa el IWebRequestCreate de la interfaz, usando la RegisterPrefix método o el archivo de configuración.

En el ejemplo siguiente se muestra cómo crear un WebRequest de instancia y devolver la respuesta.

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

WebPermission

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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

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: