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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 à

Partager via