HttpListener Clase

Referencia

Definición

Espacio de nombres:: System.Net

Ensamblado:: System.Net.HttpListener.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Source:: HttpListener.cs

Source:: HttpListener.cs

Source:: HttpListener.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona un agente de escucha del protocolo HTTP sencillo y controlado mediante programación. Esta clase no puede heredarse.

public ref class HttpListener sealed : IDisposable

public sealed class HttpListener : IDisposable

type HttpListener = class
    interface IDisposable

Public NotInheritable Class HttpListener
Implements IDisposable

Herencia: Object
HttpListener

Implementaciones: IDisposable

Ejemplos

// 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

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para HttpListener.

Constructores

HttpListener()

Inicializa una nueva instancia de la clase HttpListener.

Propiedades

AuthenticationSchemes	Obtiene o establece el esquema utilizado para autenticar los clientes.
AuthenticationSchemeSelectorDelegate	Obtiene o establece el delegado al que se llama para determinar el protocolo utilizado para autenticar los clientes.
DefaultServiceNames	Obtiene una lista predeterminada de nombres de proveedores de servicios (SPN) determinada por los prefijos registrados.
ExtendedProtectionPolicy	Obtiene o establece el objeto ExtendedProtectionPolicy que se va a emplear para la protección extendida para una sesión.
ExtendedProtectionSelectorDelegate	Obtiene o establece el delegado llamado para determinar el objeto ExtendedProtectionPolicy que se va a emplear para cada solicitud.
IgnoreWriteExceptions	Obtiene o establece un valor Boolean que especifica si su aplicación recibe las excepciones que aparecen cuando HttpListener envía la respuesta al cliente.
IsListening	Obtiene un valor que indica si se ha iniciado HttpListener.
IsSupported	Obtiene un valor que indica si HttpListener se puede utilizar con el sistema operativo actual.
Prefixes	Obtiene los prefijos de identificador uniforme de recursos (URI) controlados por este objeto HttpListener.
Realm	Obtiene o establece el territorio, o partición de recurso, asociado con el objeto HttpListener.
TimeoutManager	El administrador de tiempo de espera para esta instancia HttpListener.
UnsafeConnectionNtlmAuthentication	Obtiene o establece un valor Boolean que controla si, cuando se utiliza NTLM, se requieren solicitudes adicionales que utilicen la misma conexión del protocolo TCP (Protocolo de control de transmisión) para la autenticación.

Métodos

Abort()	Cierra inmediatamente el objeto HttpListener, descartando todas las solicitudes actualmente puestas en la cola.
BeginGetContext(AsyncCallback, Object)	Empieza a recuperar de forma asincrónica una solicitud de entrada.
Close()	Cierra HttpListener.
EndGetContext(IAsyncResult)	Finaliza una operación asincrónica para recuperar una solicitud de cliente de entrada.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetContext()	Espera a una solicitud de entrada y vuelve cuando se recibe una.
GetContextAsync()	Espera una solicitud entrante como una operación asincrónica.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Start()	Permite que esta instancia reciba solicitudes de entrada.
Stop()	Hace que esta instancia deje de recibir nuevas solicitudes entrantes y termine el procesamiento de todas las solicitudes en curso.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Libera los recursos mantenidos por este objeto HttpListener.

Se aplica a

Compartir a través de