Esta documentación está archivada y no tiene mantenimiento.

WebRequest (Clase)

Actualización: noviembre 2007

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

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

[SerializableAttribute]
public abstract class WebRequest : MarshalByRefObject, 
	ISerializable
/** @attribute SerializableAttribute */ 
public abstract class WebRequest extends MarshalByRefObject implements ISerializable
public abstract class WebRequest extends MarshalByRefObject implements ISerializable

WebRequest es la clase base abstract del modelo de solicitud/respuesta de .NET Framework para obtener acceso a datos desde Internet. Una aplicación que utilice el modelo de solicitud/respuesta puede solicitar datos de Internet de una manera que sea válida para los protocolos, donde la aplicación trabaja con instancias de la clase WebRequest mientras que las clases descendientes específicas del protocolo se encargan de los detalles de la solicitud.

Las solicitudes se envían desde una aplicación a un identificador URI concreto, como una página Web de un servidor. El identificador URI determina la clase descendiente adecuada que se debe crear a partir de una lista de descendientes de WebRequest registrados para la aplicación. Los descendientes de WebRequest 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 éste.

La clase WebRequest produce WebException cuando se producen errores en el acceso a un recurso de Internet. La propiedad Status es uno de los valores de WebExceptionStatus que indica el origen del error. Cuando Status es WebExceptionStatus.ProtocolError, la propiedad Response contiene el valor de WebResponse recibido del recurso de Internet.

Dado que WebRequest es una clase abstract, el comportamiento real de las instancias de 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.

5t9y35bd.alert_note(es-es,VS.90).gifNota:

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

5t9y35bd.alert_note(es-es,VS.90).gifNota:

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ícito para hacerlo.

Notas para los herederos:

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

En el ejemplo siguiente se muestra cómo crear una instancia de WebRequest 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 

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

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.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

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

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0
Mostrar: