HttpListenerRequest.Url 属性 (System.Net) | Microsoft Learn

link之家
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
相关文章推荐
打盹的木瓜 · 配置Jstl的Maven依赖_梦回沉沦的博客 ...· 1 年前 ·
想出国的洋葱 · Pandas数据结构之DataFrame常见 ...· 1 年前 ·
温柔的桔子 · Visual Studio 2017 ...· 1 年前 ·
下面的代码示例演示如何使用 Url 属性。

   public static void ShowRequestProperties1 (HttpListenerRequest request)
    // Display the MIME types that can be used in the response.
    string[] types = request.AcceptTypes;
    if (types != null)
        Console.WriteLine("Acceptable MIME types:");
        foreach (string s in types)
            Console.WriteLine(s);
    // Display the language preferences for the response.
    types = request.UserLanguages;
    if (types != null)
        Console.WriteLine("Acceptable natural languages:");
        foreach (string l in types)
            Console.WriteLine(l);
    // Display the URL used by the client.
    Console.WriteLine("URL: {0}", request.Url.OriginalString);
    Console.WriteLine("Raw URL: {0}", request.RawUrl);
    Console.WriteLine("Query: {0}", request.QueryString);
    // Display the referring URI.
    Console.WriteLine("Referred by: {0}", request.UrlReferrer);
    //Display the HTTP method.
    Console.WriteLine("HTTP Method: {0}", request.HttpMethod);
    //Display the host information specified by the client;
    Console.WriteLine("Host name: {0}", request.UserHostName);
    Console.WriteLine("Host address: {0}", request.UserHostAddress);
    Console.WriteLine("User agent: {0}", request.UserAgent);
   
    Public Shared Sub ShowRequestProperties1(ByVal request As HttpListenerRequest)
    ' Display the MIME types that can be used in the response.
    Dim types As String() = request.AcceptTypes
    If types IsNot Nothing Then
        Console.WriteLine("Acceptable MIME types:")
        For Each s As String In types
            Console.WriteLine(s)
    End If
    ' Display the language preferences for the response.
    types = request.UserLanguages
    If types IsNot Nothing Then
        Console.WriteLine("Acceptable natural languages:")
        For Each l As String In types
            Console.WriteLine(l)
    End If
    ' Display the URL used by the client.
    Console.WriteLine("URL: {0}", request.Url.OriginalString)
    Console.WriteLine("Raw URL: {0}", request.RawUrl)
    Console.WriteLine("Query: {0}", request.QueryString)
    ' Display the referring URI.
    Console.WriteLine("Referred by: {0}", request.UrlReferrer)
    ' Display the HTTP method.
    Console.WriteLine("HTTP Method: {0}", request.HttpMethod)
    ' Display the host information specified by the client.
    Console.WriteLine("Host name: {0}", request.UserHostName)
    Console.WriteLine("Host address: {0}", request.UserHostAddress)
    Console.WriteLine("User agent: {0}", request.UserAgent)
End Sub
    
     属性
     
      Url
     
     允许你从 对象获取所有可用
     
      Uri
     
     信息。 如果只需要知道 URI 请求的原始文本，请考虑改用
     
      RawUrl
     
     属性。
    
    
     如果无法分析来自客户端的 ，
     
      Uri
     
     则
     
      Url
     
     属性为 null。
    
    
     属性
     
      UnescapeRequestUrl
     
     指示是否
     
      HttpListener
     
     使用原始的未转义 URI，而不是转换后的任何百分比编码值并执行其他规范化步骤的转换 URI。
    
    
     当
     
      HttpListener
     
     实例通过
     
      http.sys
     
     服务接收请求时，它会创建
     
      http.sys
     
     提供的 URI 字符串的实例，并将其公开为
     
      HttpListenerRequest.Url
     
     属性。
    
    
     
      http.sys
     
     服务公开两个请求 URI 字符串：
    
    
     
      原始 URI
     
    
    
     
      转换后的 URI
     
     
      原始 URI 是 HTTP 请求的请求行中提供的
      
       System.Uri
      
      ：
     
     
      
       GET /path/
      
     
     
      
       Host: www.contoso.com
      
     
     
      
       http.sys
      
      为上述请求提供的原始 URI 是“/path/”。 这表示 HTTP 谓词后面的字符串，因为它是通过网络发送的。
     
     
      该服务
      
       http.sys
      
      使用 HTTP 请求行和主机标头中提供的 URI 根据请求中提供的信息创建转换后的 URI，以确定请求应转发到的源服务器。 这种判断是通过将请求中的信息与一组已注册的 URI 前缀进行比较做出的。 为了能够比较这些值，需要对请求进行一些规范化。 对于上面的示例，转换后的 URI 如下所示：
     
     
      
       http://www.contoso.com/path/
      
     
     
      
       http.sys
      
      服务将
      
       Uri.Host
      
      属性值与请求行中的字符串相组合，以创建转换后的 URI。 此外，
      
       http.sys
      
      和
      
       System.Uri
      
      类还执行以下操作：
     
    
    
     
      取消转义所有百分比编码值。
     
    
    
     
      将百分比编码的非 ASCII 字符转换为 UTF-16 字符表示形式。 请注意，支持 UTF-8 和 ANSI/DBCS 字符以及 Unicode 字符（使用 %uXXXX 格式的 Unicode 编码）。
     
    
    
     
      执行其他规范化步骤，例如路径压缩。
     
     
      由于请求不包含任何有关百分比编码值使用的编码的信息，因此仅仅是通过分析百分比编码值可能无法确定正确的编码。
     
     
      因此
      
       http.sys
      
      提供了两个注册表项用于修改进程：
     
     EnableNonUTF8
如果为零，则
     
      http.sys
     
     仅接受 UTF-8 编码的 URL。
     

     

     如果不为零，则
     
      http.sys
     
     还接受请求中 ANSI 编码或 DBCS 编码的 URL。
FavorUTF8
如果不为零，则
     
      http.sys
     
     始终首先尝试将 URL 解码为 UTF-8；如果这种转换失败并且 EnableNonUTF8 不为零，则 Http.sys 随后会尝试将 URL 解码为 ANSI 或 DBCS。
     

     

     如果为零（并且 EnableNonUTF8 不为零），则
     
      http.sys
     
     会尝试将 URL 解码为 ANSI 或 DBCS；如果不成功，则尝试进行 UTF-8 转换。
     
      当
      
       HttpListener
      
      收到请求时，它将使用
      
       http.sys
      
      中转换的 URI 作为
      
       Url
      
      属性的输入。
     
     
      除了 URI 中的字符和数字外，还需要指定支持字符。 例如，以下 URI 用于检索客户编号“1/3812”的客户信息：
     
     
      
       http://www.contoso.com/Customer('1%2F3812')/
      
     
     
      请注意 Uri (%2F) 中的百分比编码斜杠。 这种编码是必要的，因为在本例中，斜杠字符代表数据而不是路径分隔符。
     
     
      将字符串传递给 Uri 构造函数会生成以下 URI：
     
     
      
       http://www.contoso.com/Customer('1/3812')/
      
     
     
      将路径拆分为多个段会生成以下元素：
     
     
      
       Customer('1
      
     
     
      
       3812')
      
     
     
      这不是请求发送者的意图。
     
     
      如果 属性
      
       UnescapeRequestUrl
      
      设置为 false，则当 收到请求时
      
       HttpListener
      
      ，它将使用原始 URI 而不是转换
      
       http.sys
      
      的 URI 作为属性的
      
       Url
      
      输入。