HttpListenerRequest HttpListenerRequest HttpListenerRequest HttpListenerRequest Class

Definición

Describe una solicitud HTTP de entrada a un objeto HttpListener.Describes an incoming HTTP request to an HttpListener object. Esta clase no puede heredarse.This class cannot be inherited.

public ref class HttpListenerRequest sealed
public sealed class HttpListenerRequest
type HttpListenerRequest = class
Public NotInheritable Class HttpListenerRequest
Herencia
HttpListenerRequestHttpListenerRequestHttpListenerRequestHttpListenerRequest

Ejemplos

En el ejemplo de código siguiente se muestra cómo recibir y responder HttpListenerRequesta.The following code example demonstrates how to receive and respond to a HttpListenerRequest.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
        return;
    }
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");
    
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request. 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}
Public Shared Sub SimpleListenerExample(prefixes As String())
    If Not HttpListener.IsSupported Then
        Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
        Return
    End If
    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing Or prefixes.Length = 0 Then
        Throw New ArgumentException("prefixes")
    End If

    ' Create a listener
    Dim listener = New HttpListener()

    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next
    listener.Start()
    Console.WriteLine("Listening...")
    ' Note: The GetContext method blocks while waiting for a request.
    Dim context As HttpListenerContext = listener.GetContext()
    Console.WriteLine("Listening...")
    ' Obtain a response object
    Dim request As HttpListenerRequest = context.Request
    ' Construct a response.
    Dim response As HttpListenerResponse = context.Response
    Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
    Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    Dim output As System.IO.Stream = response.OutputStream
    output.Write(buffer, 0, buffer.Length)
    'You must close the output stream.
    output.Close()
    listener.Stop()
End Sub

Comentarios

Cuando un cliente realiza una solicitud a un identificador uniforme de recursos (URI) controlado por un HttpListener objeto HttpListener , proporciona un HttpListenerContext objeto que contiene información sobre el remitente, la solicitud y la respuesta que se envía al cliente.When a client makes a request to a Uniform Resource Identifier (URI) handled by an HttpListener object, the HttpListener provides a HttpListenerContext object that contains information about the sender, the request, and the response that is sent to the client. La HttpListenerContext.Request propiedad devuelve el HttpListenerRequest objeto que describe la solicitud.The HttpListenerContext.Request property returns the HttpListenerRequest object that describes the request.

El HttpListenerRequest objeto contiene información sobre la solicitud, como la cadena de HttpMethod solicitud, UserAgent la cadena y los datos del cuerpo de la InputStream solicitud (vea la propiedad).The HttpListenerRequest object contains information about the request, such as the request HttpMethod string, UserAgent string, and request body data (see the InputStream property).

Para responder a la solicitud, debe obtener la respuesta asociada mediante la Response propiedad.To reply to the request, you must get the associated response using the Response property.

Propiedades

AcceptTypes AcceptTypes AcceptTypes AcceptTypes

Obtiene los tipos MIME aceptados por el cliente.Gets the MIME types accepted by the client.

ClientCertificateError ClientCertificateError ClientCertificateError ClientCertificateError

Obtiene un código de error que identifica un problema con el objeto X509Certificate proporcionado por el cliente.Gets an error code that identifies a problem with the X509Certificate provided by the client.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

Obtiene la codificación de contenido que se puede utilizar con los datos enviados con la solicitudGets the content encoding that can be used with data sent with the request

ContentLength64 ContentLength64 ContentLength64 ContentLength64

Obtiene la longitud de los datos de cuerpo incluidos en la solicitud.Gets the length of the body data included in the request.

ContentType ContentType ContentType ContentType

Obtiene el tipo MIME de los datos del cuerpo incluidos en la solicitud.Gets the MIME type of the body data included in the request.

Cookies Cookies Cookies Cookies

Obtiene las cookies enviadas con la solicitud.Gets the cookies sent with the request.

HasEntityBody HasEntityBody HasEntityBody HasEntityBody

Obtiene un valor Boolean que indica si la solicitud tiene asociados datos de cuerpo.Gets a Boolean value that indicates whether the request has associated body data.

Headers Headers Headers Headers

Obtiene la colección de pares nombre de encabezado/valor enviados en la solicitud.Gets the collection of header name/value pairs sent in the request.

HttpMethod HttpMethod HttpMethod HttpMethod

Obtiene el método HTTP especificado por el cliente.Gets the HTTP method specified by the client.

InputStream InputStream InputStream InputStream

Obtiene una secuencia que contiene los datos del cuerpo enviados por el cliente.Gets a stream that contains the body data sent by the client.

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Obtiene un valor Boolean que indica si el cliente que envía esta solicitud está autenticado.Gets a Boolean value that indicates whether the client sending this request is authenticated.

IsLocal IsLocal IsLocal IsLocal

Obtiene un valor Boolean que indica si la solicitud se envía desde el equipo local.Gets a Boolean value that indicates whether the request is sent from the local computer.

IsSecureConnection IsSecureConnection IsSecureConnection IsSecureConnection

Obtiene un valor Boolean que indica si la conexión TCP utilizada para enviar la solicitud está utilizando el protocolo Secure Sockets Layer (SSL).Gets a Boolean value that indicates whether the TCP connection used to send the request is using the Secure Sockets Layer (SSL) protocol.

IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest

Obtiene un valor Boolean que indica si la conexión TCP fue una solicitud WebSocket.Gets a Boolean value that indicates whether the TCP connection was a WebSocket request.

KeepAlive KeepAlive KeepAlive KeepAlive

Obtiene un valor Boolean que indica si el cliente solicita una conexión persistente.Gets a Boolean value that indicates whether the client requests a persistent connection.

LocalEndPoint LocalEndPoint LocalEndPoint LocalEndPoint

Obtiene la dirección IP y el número de puerto del servidor a los que se dirige la solicitud.Gets the server IP address and port number to which the request is directed.

ProtocolVersion ProtocolVersion ProtocolVersion ProtocolVersion

Obtiene la versión de HTTP utilizada por el cliente que hace la solicitud.Gets the HTTP version used by the requesting client.

QueryString QueryString QueryString QueryString

Obtiene la cadena de consulta incluida en la solicitud.Gets the query string included in the request.

RawUrl RawUrl RawUrl RawUrl

Obtiene la información de la dirección URL (sin el host y el puerto) solicitada por el cliente.Gets the URL information (without the host and port) requested by the client.

RemoteEndPoint RemoteEndPoint RemoteEndPoint RemoteEndPoint

Obtiene la dirección IP y el número de puerto de cliente desde los que se originó la solicitud.Gets the client IP address and port number from which the request originated.

RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier

Obtiene el identificador de la solicitud HTTP de entrada.Gets the request identifier of the incoming HTTP request.

ServiceName ServiceName ServiceName ServiceName

Obtiene el nombre del proveedor de servicios (SPN) que el cliente envió en la solicitud.Gets the Service Provider Name (SPN) that the client sent on the request.

TransportContext TransportContext TransportContext TransportContext

Obtiene el objeto TransportContext de la solicitud de cliente.Gets the TransportContext for the client request.

Url Url Url Url

Obtiene el objeto Uri solicitado por el cliente.Gets the Uri object requested by the client.

UrlReferrer UrlReferrer UrlReferrer UrlReferrer

Obtiene el identificador URI del recurso que remitió el cliente al servidor.Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.

UserAgent UserAgent UserAgent UserAgent

Obtiene el agente de usuario presentado por el cliente.Gets the user agent presented by the client.

UserHostAddress UserHostAddress UserHostAddress UserHostAddress

Obtiene la dirección IP y el número de puerto del servidor a los que se dirige la solicitud.Gets the server IP address and port number to which the request is directed.

UserHostName UserHostName UserHostName UserHostName

Obtiene el nombre DNS y, si se proporciona, el número de puerto especificado por el cliente.Gets the DNS name and, if provided, the port number specified by the client.

UserLanguages UserLanguages UserLanguages UserLanguages

Obtiene los idiomas naturales preferidos para la respuesta.Gets the natural languages that are preferred for the response.

Métodos

BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object)

Inicia una solicitud asincrónica para el certificado X.509 v.3 del cliente.Begins an asynchronous request for the client's X.509 v.3 certificate.

EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult)

Finaliza una solicitud asincrónica para el certificado X.509 v.3 del cliente.Ends an asynchronous request for the client's X.509 v.3 certificate.

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)
GetClientCertificate() GetClientCertificate() GetClientCertificate() GetClientCertificate()

Recupera el certificado X.509 v.3 del cliente.Retrieves the client's X.509 v.3 certificate.

GetClientCertificateAsync() GetClientCertificateAsync() GetClientCertificateAsync() GetClientCertificateAsync()

Recupera el certificado de X.509 v.3 del cliente como una operación asincrónica.Retrieves the client's X.509 v.3 certificate as an asynchronous operation.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

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

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: