Export (0) Print
Expand All

HttpListenerRequest.UrlReferrer Property

Note: This property is new in the .NET Framework version 2.0.

Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.

Namespace: System.Net
Assembly: System (in system.dll)

'Declaration
Public ReadOnly Property UrlReferrer As Uri
'Usage
Dim instance As HttpListenerRequest
Dim value As Uri

value = instance.UrlReferrer

/** @property */
public Uri get_UrlReferrer ()

public function get UrlReferrer () : Uri

Property Value

A Uri object that contains the text of the request's Referer header, or a null reference (Nothing in Visual Basic) if the header was not included in the request.

If a client has followed a hyperlink to the requested URI, its request might contain a Referrer header that identifies the URI of the resource that contained the hyperlink.

Clients can falsify or choose not to present a Referer header. Therefore, while the UrlReferrer property can be useful for identifying broad trends in Web traffic; you should not use it as part of an authorization scheme to control access to data.

For a complete list of request headers, see the HttpRequestHeader enumeration.

The following code example demonstrates using this property.

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);
}

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft