HttpListener Classe
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
-
HttpListener
- Implémente
// 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
Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour HttpListener.
Http |
Initialise une nouvelle instance de la classe HttpListener. |
Authentication |
Obtient ou définit le schéma utilisé pour authentifier les clients. |
Authentication |
Obtient ou définit le délégué appelé pour déterminer le protocole utilisé pendant l'authentification des clients. |
Default |
Obtient une liste par défaut des noms de fournisseurs de services (SPN) déterminée par les préfixes enregistrés. |
Extended |
Obtient ou définit le ExtendedProtectionPolicy à utiliser pour la protection étendue d’une session. |
Extended |
Obtient ou définit le délégué appelé pour déterminer le ExtendedProtectionPolicy à utiliser pour chaque demande. |
Ignore |
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. |
Is |
Obtient une valeur qui indique si HttpListener a été démarré. |
Is |
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. |
Timeout |
Gestionnaire de délai d'attente pour cette instance HttpListener. |
Unsafe |
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. |
Abort() |
Arrête immédiatement l'objet HttpListener, en ignorant toutes les demandes actuellement mises en file d'attente. |
Begin |
Commence à récupérer une demande entrante de façon asynchrone. |
Close() |
Arrête le HttpListener. |
End |
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) |
Get |
Attend une demande entrante et retourne les résultats quand elle est reçue. |
Get |
Attend une demande entrante en tant qu'opération asynchrone. |
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Memberwise |
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. |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
IDisposable. |
Libère les ressources détenues par cet objet HttpListener. |
Produit | Versions |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires: