HttpListener Classe

Définition

Espace de noms:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Fournit un écouteur de protocole HTTP simple et contrôlé par programmation. Cette classe ne peut pas être héritée.

public ref class HttpListener sealed : IDisposable
public sealed class HttpListener : IDisposable
type HttpListener = class
    interface IDisposable
Public NotInheritable Class HttpListener
Implements IDisposable
Héritage
Object
HttpListener
Implémente
IDisposable

Exemples

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

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour HttpListener.

Constructeurs

Nom Description
HttpListener()

Initialise une nouvelle instance de la classe HttpListener.

Propriétés

Nom Description
AuthenticationSchemes

Obtient ou définit le schéma utilisé pour authentifier les clients.
AuthenticationSchemeSelectorDelegate

Obtient ou définit le délégué appelé pour déterminer le protocole utilisé pour authentifier les clients.
DefaultServiceNames

Obtient une liste par défaut des noms de fournisseurs de services (SPN) déterminés par les préfixes inscrits.
ExtendedProtectionPolicy

Obtient ou définit la valeur à utiliser pour une ExtendedProtectionPolicy protection étendue pour une session.
ExtendedProtectionSelectorDelegate

Obtient ou définit le délégué appelé pour déterminer l’utilisation ExtendedProtectionPolicy de chaque requête.
IgnoreWriteExceptions

Obtient ou définit une Boolean valeur qui spécifie si votre application reçoit des exceptions qui se produisent lorsqu’une HttpListener réponse envoie la réponse au client.
IsListening

Obtient une valeur qui indique si HttpListener elle a été démarrée.
IsSupported

Obtient une valeur qui indique si HttpListener vous pouvez utiliser le système d’exploitation actuel.
Prefixes

Obtient les préfixes URI (Uniform Resource Identifier) gérés par cet HttpListener objet.
Realm

Obtient ou définit le domaine ou la partition de ressources associé à cet HttpListener objet.
TimeoutManager

Gestionnaire de délai d’expiration pour cette HttpListener instance.
UnsafeConnectionNtlmAuthentication

Obtient ou définit une Boolean valeur qui contrôle si, lorsque NTLM est utilisé, des requêtes supplémentaires utilisant la même connexion TCP (Transmission Control Protocol) sont requises pour s’authentifier.

Méthodes

Nom Description
Abort()

Arrête immédiatement l’objet HttpListener , en ignorant toutes les demandes actuellement mises en file d’attente.
BeginGetContext(AsyncCallback, Object)

Commence à récupérer de façon asynchrone une requête entrante.
Close()

Arrête le HttpListener.
EndGetContext(IAsyncResult)

Termine une opération asynchrone pour récupérer une requête cliente entrante.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetContext()

Attend une demande entrante et retourne une fois qu’une demande est reçue.
GetContextAsync()

Attend une requête entrante en tant qu’opération asynchrone.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Start()

Permet à cette instance de recevoir des demandes entrantes.
Stop()

Provoque l’arrêt de la réception de nouvelles demandes entrantes et met fin au traitement de toutes les demandes en cours.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

Nom Description
IDisposable.Dispose()

Libère les ressources détenues par cet HttpListener objet.

S’applique à

Voir aussi