HttpListener Classe

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.HttpListener.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
HttpListener.cs
Source:
HttpListener.cs
Source:
HttpListener.cs

Fournit un écouteur de protocole HTTP simple, contrôlé par programme. 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 Remarques supplémentaires sur l’API pour HttpListener.

Constructeurs

HttpListener()

Initialise une nouvelle instance de la classe HttpListener.

Propriétés

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é pendant l'authentification des clients.
DefaultServiceNames

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

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

Obtient ou définit le délégué appelé pour déterminer le ExtendedProtectionPolicy à utiliser pour chaque demande.
IgnoreWriteExceptions

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

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

Obtient une valeur qui indique si HttpListener peut être utilisé avec le système d'exploitation actuel.
Prefixes

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

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

Gestionnaire de délai d'attente pour cette instance HttpListener.
UnsafeConnectionNtlmAuthentication

Obtient ou définit une valeur Boolean qui contrôle si, quand NTLM est utilisé, les demandes supplémentaires utilisant la même connexion TCP (Transmission Control Protocol) doivent être authentifiées.

Méthodes

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 une demande entrante de façon asynchrone.
Close()

Arrête le HttpListener.
EndGetContext(IAsyncResult)

Met fin à une opération asynchrone pour récupérer une demande du client 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 les résultats quand elle est reçue.
GetContextAsync()

Attend une demande entrante en tant qu'opération asynchrone.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Start()

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

Entraîne l’arrêt de la réception de nouvelles demandes entrantes par cette instance et arrête le 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

IDisposable.Dispose()

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

S’applique à

Voir aussi