HttpListenerPrefixCollection.Add(String) Método

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Adiciona um prefixo Uniform Resource Identifier (URI) à coleção.

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)

Parâmetros

uriPrefix
String

A String que identifica a informação de URI que é comparada nos pedidos recebidos. O prefixo deve ser terminado com uma barra para a frente ("/").

Implementações

Add(T)

Exceções

ArgumentNullException

uriPrefix é null.

ArgumentException

uriPrefix não utiliza o esquema http:// ou https://. Estes são os únicos esquemas suportados para HttpListener objetos.

-ou-

uriPrefix não é um prefixo de URI corretamente formatado. Certifique-se de que a cadeia termina com um "/".

ObjectDisposedException

A HttpListener coleção associada a esta coleção está encerrada.

HttpListenerException

Uma chamada de função do Windows falhou. Verifique a propriedade da ErrorCode exceção para determinar a causa da dela. Esta exceção é lançada se outro HttpListener já tiver adicionado o prefixo uriPrefix.

Exemplos

O exemplo de código seguinte cria um HttpListener e adiciona prefixos especificados pelo utilizador ao seu 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

Observações

Este método adiciona um prefixo URI ao conjunto de prefixos geridos pelo objeto associado HttpListener . Ao verificar uriPrefix se é válido, o caso é ignorado.

Uma cadeia de prefixos URI é composta por um esquema (http ou https), um host, uma porta opcional e um caminho opcional, por exemplo, "http://www.contoso.com:8080/customerData/". O prefixo deve ser terminado com uma barra para a frente ("/"). O HttpListener com o prefixo que mais corresponde a um URI solicitado responde ao pedido. Múltiplos HttpListener objetos não podem adicionar o mesmo prefixo. É lançada uma HttpListenerException exceção se a HttpListener adicionar um prefixo já em uso.

Quando uma porta é especificada, o elemento anfitrião pode ser substituído por "*" para indicar que aceita HttpListener pedidos enviados para a porta caso o URI solicitado não corresponda a nenhum outro prefixo. Por exemplo, para receber todos os pedidos enviados para a porta 8080 quando o URI solicitado não é tratado por outro HttpListener, o prefixo é "http://*:8080/". De forma semelhante, para especificar que aceita HttpListener todos os pedidos enviados para uma porta, substitua o elemento anfitrião pelo carácter "+" ".https://+:8080/ Os caracteres "*" e "+" podem estar presentes em prefixos que incluem caminhos.

A partir de .NET 4.5.3 e Windows 10, subdomínios curinga são suportados em prefixos URI geridos por um objeto HttpListener. Para especificar um subdomínio curinga, use o carácter "*" como parte do nome do host num prefixo URI: por exemplo, http://*.foo.com/, e passe este argumento para o método HttpListenerPrefixCollection.Add (HttpListenerPrefixCollection.Add). Isto funcionará em .NET 4.5.3 e Windows 10; em versões anteriores, geraria um HttpListenerException

Aplica-se a

Ver também