HttpListenerRequest.Url 屬性

定義

命名空間:

System.Net

組件:

System.Net.HttpListener.dll

來源:

HttpListenerRequest.cs

取得用戶端所要求的 Uri 物件。

public:
 property Uri ^ Url { Uri ^ get(); };

public Uri? Url { get; }

member this.Url : Uri

Public ReadOnly Property Url As Uri

屬性值

Uri

Uri 物件，識別用戶端所要求的資源。

範例

下列程式代碼範例示範如何使用 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)
        Next
    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)
        Next
    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 和 Host 標頭，從要求中提供的資訊建立已轉換的 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	1	如果為零，http.sys 只會接受 UTF-8 編碼的 URL。 如果為非零，http.sys 也會接受要求中 ANSI 或 DBCS 編碼的 URL。
FavorUTF8	1	如果為非零，http.sys 一律會先嘗試將 URL 解碼為 UTF-8；如果該轉換失敗且 EnableNonUTF8 為非零，Http.sys 會接著嘗試將其解碼為 ANSI 或 DBCS。 如果為零 (且 EnableNonUTF8 為非零)，http.sys 會嘗試將其解碼為 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，而不是將轉換的 URI 從 http.sys 做為屬性的Url輸入。

另請參閱

• HttpListenerElement
• HttpListener
• HttpListenerContext
• HttpListenerResponse
• 網路設定結構描述
• <HTTPListener> 元素 (網路設定)