HttpListenerRequest.UrlReferrer Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.HttpListener.dll

Zdroj:

HttpListenerRequest.cs

Získá identifikátor URI (Uniform Resource Identifier) prostředku, který odkazuje klienta na server.

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

public Uri? UrlReferrer { get; }

member this.UrlReferrer : Uri

Public ReadOnly Property UrlReferrer As Uri

Hodnota vlastnosti

Uri

Objekt Uri , který obsahuje text hlavičky Referer požadavku nebo null pokud hlavička nebyla zahrnuta do požadavku.

Příklady

Následující příklad kódu ukazuje použití této vlastnosti.

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

Poznámky

Pokud klient sledoval hypertextový odkaz na požadovaný identifikátor URI, jeho požadavek může obsahovat hlavičku Referrer , která identifikuje identifikátor URI prostředku, který obsahoval hypertextový odkaz.

Klienti můžou záhlaví zfalšovat nebo se rozhodnout, že záhlaví nepředkládají Referer . Proto i když UrlReferrer vlastnost může být užitečná pro identifikaci základních trendů webového provozu, neměli byste ji používat jako součást autorizačního schématu pro řízení přístupu k datům.

Úplný seznam hlaviček požadavků najdete ve výčtu HttpRequestHeader .

Hodnota UrlReferrer má hodnotu null, pokud požadavek neobsahuje žádnou Referrer hlavičku Referrer nebo pokud je hlavička v požadavku, ale neanalybuje se na platnou Urihodnotu .

Viz také

• HttpListener
• HttpListenerContext
• HttpListenerResponse