Compartir vía


HttpListener Clase

Definición

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
HttpListener
Implementaciones

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

Consulte también