HttpListenerPrefixCollection.Add(String) Méthode

Référence

Définition

Espace de noms:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: HttpListenerPrefixCollection.cs

Source:: HttpListenerPrefixCollection.cs

Source:: HttpListenerPrefixCollection.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.

Ajoute un préfixe URI (Uniform Resource Identifier) à la collection.

public:
 virtual void Add(System::String ^ uriPrefix);

public void Add (string uriPrefix);

abstract member Add : string -> unit
override this.Add : string -> unit

Public Sub Add (uriPrefix As String)

Paramètres

uriPrefix: String

Un String qui identifie les informations d’URI qui sont comparées dans les demandes entrantes. Le préfixe doit se terminer par une barre oblique (« / »).

Implémente

Add(T)

Exceptions

ArgumentNullException

uriPrefix a la valeur null.

ArgumentException

uriPrefix n’utilise pas le schéma http:// ou https://. Ces schémas sont les seuls pris en charge pour les objets HttpListener.

- ou -

uriPrefix n’est pas un préfixe d’URI correctement mis en forme. Assurez-vous que la chaîne se termine par une barre oblique (« / »).

ObjectDisposedException

Le HttpListener associé à cette collection est fermé.

HttpListenerException

Un appel de fonction Windows a échoué. Vérifiez la propriété ErrorCode de l’exception pour déterminer la cause de l’exception. Cette exception est levée si un autre HttpListener a déjà ajouté le préfixe uriPrefix.

Exemples

L’exemple de code suivant crée un et ajoute des HttpListener préfixes spécifiés par l’utilisateur à son HttpListenerPrefixCollection.

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

Cette méthode ajoute un préfixe URI à l’ensemble de préfixes gérés par l’objet associé HttpListener . Lors de la vérification uriPrefix de sa validité, la casse est ignorée.

Une chaîne de préfixe d’URI est composée d’un schéma (http ou https), d’un hôte, d’un port facultatif et d’un chemin d’accès facultatif, par exemple, «http://www.contoso.com:8080/customerData/ ». Le préfixe doit se terminer par une barre oblique (« / »). avec HttpListener le préfixe qui correspond le plus étroitement à un URI demandé répond à la demande. Plusieurs HttpListener objets ne peuvent pas ajouter le même préfixe. Une HttpListenerException exception est levée si un HttpListener ajoute un préfixe déjà utilisé.

Lorsqu’un port est spécifié, l’élément hôte peut être remplacé par «* » pour indiquer que le accepte les HttpListener demandes envoyées au port si l’URI demandé ne correspond à aucun autre préfixe. Par exemple, pour recevoir toutes les requêtes envoyées au port 8080 lorsque l’URI demandé n’est géré par aucun autre HttpListener, le préfixe est «http://*:8080/ ». De même, pour spécifier que le HttpListener accepte toutes les demandes envoyées à un port, remplacez l’élément hôte par le caractère «+ », «https://+:8080/ ». Les caractères «* » et «+ » peuvent être présents dans des préfixes qui incluent des chemins d’accès.

À compter de .NET 4.5.3 et de Windows 10, les sous-domaines génériques sont pris en charge dans les préfixes d’URI gérés par un HttpListener objet. Pour spécifier un sous-domaine générique, utilisez le caractère « * » dans le nom d’hôte dans un préfixe URI : par exemple, http://*.foo.com/, et passez-le comme argument à la méthode HttpListenerPrefixCollection.Add. Cela fonctionnera sur .NET 4.5.3 et Windows 10 ; dans les versions antérieures, cela générerait unHttpListenerException

S’applique à

Voir aussi

HttpListener