HttpListenerRequest.UrlReferrer Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.HttpListener.dll

Исходный код:

HttpListenerRequest.cs

Возвращает URI ресурса, который перенаправляет клиент на сервер.

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

public Uri? UrlReferrer { get; }

member this.UrlReferrer : Uri

Public ReadOnly Property UrlReferrer As Uri

Значение свойства

Uri

Объект Uri, содержащий текст заголовка запроса Referer, или null, если заголовок не был включен в запрос.

Примеры

В следующем примере кода показано использование этого свойства.

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

Комментарии

Если клиент перешел по гиперссылке на запрошенный URI, его запрос может содержать Referrer заголовок, определяющий URI ресурса, содержащего гиперссылку.

Клиенты могут фальсифицировать или отказаться от представления заголовка Referer . Таким образом, хотя UrlReferrer свойство может быть полезно для определения основных тенденций в веб-трафике, его не следует использовать в рамках схемы авторизации для управления доступом к данным.

Полный список заголовков запросов см. в перечислении HttpRequestHeader .

Имеет UrlReferrer значение NULL, если в запросе нет Referrer заголовка или если Referrer заголовок присутствует в запросе, но не анализирует допустимый Uri.

См. также раздел

• HttpListener
• HttpListenerContext
• HttpListenerResponse