HttpListenerRequest.UrlReferrer Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.HttpListener.dll

Źródło:

HttpListenerRequest.cs

Pobiera identyfikator URI (Uniform Resource Identifier) zasobu, który odniósł klienta do serwera.

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

public Uri? UrlReferrer { get; }

member this.UrlReferrer : Uri

Public ReadOnly Property UrlReferrer As Uri

Wartość właściwości

Uri

Uri Obiekt, który zawiera tekst nagłówka Referer żądania lub null jeśli nagłówek nie został uwzględniony w żądaniu.

Przykłady

Poniższy przykład kodu przedstawia użycie tej właściwości.

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

Uwagi

Jeśli klient podąża za hiperlinkiem do żądanego identyfikatora URI, jego żądanie może zawierać Referrer nagłówek identyfikujący identyfikator URI zasobu, który zawierał hiperłącze.

Klienci mogą fałszować lub nie prezentować nagłówka Referer . W związku z tym UrlReferrer właściwość może być przydatna do identyfikowania podstawowych trendów w ruchu internetowym. Nie należy jej używać jako części schematu autoryzacji do kontrolowania dostępu do danych.

Aby uzyskać pełną listę nagłówków żądań, zobacz HttpRequestHeader wyliczenie.

Parametr UrlReferrer ma wartość null, gdy w żądaniu nie Referrer ma nagłówka lub gdy Referrer nagłówek znajduje się w żądaniu, ale nie analizuje prawidłowego Uri.

Zobacz też

• HttpListener
• HttpListenerContext
• HttpListenerResponse