HttpListenerRequest.UrlReferrer Propriedade

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.HttpListener.dll

Origem:

HttpListenerRequest.cs

Obtém o URI (Uniform Resource Identifier) do recurso que encaminhou o cliente para o servidor.

public Uri? UrlReferrer { get; }

Valor da propriedade

Uri

Um objeto Uri que contém o texto do cabeçalho Referer da solicitação ou null se o cabeçalho não tiver sido incluído na solicitação.

Exemplos

O exemplo de código a seguir demonstra o uso dessa propriedade.

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

Comentários

Se um cliente seguiu um hiperlink para o URI solicitado, sua solicitação pode conter um Referrer cabeçalho que identifica o URI do recurso que continha o hiperlink.

Os clientes podem falsificar ou optar por não apresentar um Referer cabeçalho. Portanto, embora a UrlReferrer propriedade possa ser útil para identificar tendências básicas no tráfego da Web; você não deve usá-la como parte de um esquema de autorização para controlar o acesso aos dados.

Para obter uma lista completa de cabeçalhos de solicitação, consulte a HttpRequestHeader enumeração .

O UrlReferrer é nulo quando não há nenhum Referrer cabeçalho na solicitação ou quando o Referrer cabeçalho está presente na solicitação, mas não analisa um válido Uri.

Confira também

• HttpListener
• HttpListenerContext
• HttpListenerResponse