HttpListenerRequest.UrlReferrer Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListenerRequest.cs

Obtient l'URI (Uniform Resource Identifier) de la ressource qui a signalé le client au serveur.

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

public Uri? UrlReferrer { get; }

member this.UrlReferrer : Uri

Public ReadOnly Property UrlReferrer As Uri

Valeur de propriété

Uri

Objet Uri contenant le texte de l'en-tête Referer de la demande, ou null si l'en-tête n'a pas été compris dans la demande.

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété.

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

Remarques

Si un client a suivi un lien hypertexte vers l’URI demandé, sa demande peut contenir un Referrer en-tête qui identifie l’URI de la ressource qui contenait le lien hypertexte.

Les clients peuvent falsifier ou choisir de ne pas présenter d’en-tête Referer . Par conséquent, bien que la UrlReferrer propriété puisse être utile pour identifier les tendances de base du trafic Web, vous ne devez pas l’utiliser dans le cadre d’un schéma d’autorisation pour contrôler l’accès aux données.

Pour obtenir la liste complète des en-têtes de requête, consultez l’énumération HttpRequestHeader .

a la UrlReferrer valeur Null lorsqu’il n’y a pas Referrer d’en-tête dans la demande ou lorsque l’en-tête Referrer est présent dans la demande, mais qu’il n’analyse pas un valide Uri.

Voir aussi

• HttpListener
• HttpListenerContext
• HttpListenerResponse