HttpListenerRequest.UrlReferrer Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.HttpListener.dll

Source:

HttpListenerRequest.cs

Obtiene el identificador URI del recurso que remitió el cliente al servidor.

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

public Uri? UrlReferrer { get; }

member this.UrlReferrer : Uri

Public ReadOnly Property UrlReferrer As Uri

Valor de propiedad

Uri

Un objeto Uri que contiene el texto del encabezado Referer de la solicitud o bien null, si el encabezado no estaba incluido en la solicitud.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta propiedad.

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

Comentarios

Si un cliente ha seguido un hipervínculo al URI solicitado, su solicitud puede contener un Referrer encabezado que identifique el URI del recurso que contenía el hipervínculo.

Los clientes pueden falsificar o optar por no presentar un Referer encabezado. Por lo tanto, aunque la UrlReferrer propiedad puede ser útil para identificar tendencias básicas en el tráfico web; no debe usarla como parte de un esquema de autorización para controlar el acceso a los datos.

Para obtener una lista completa de los encabezados de solicitud, consulte la HttpRequestHeader enumeración .

UrlReferrer es null cuando no hay ningún Referrer encabezado en la solicitud o cuando el Referrer encabezado está presente en la solicitud, pero no analiza a un válidoUri.

Consulte también

• HttpListener
• HttpListenerContext
• HttpListenerResponse