Freigeben über


HttpListenerRequest.UrlReferrer Eigenschaft

Definition

Ruft den URI (Uniform Resource Identifier) der Ressource ab, die den Client an den Server verwiesen hat.

public:
 property Uri ^ UrlReferrer { Uri ^ get(); };
public Uri? UrlReferrer { get; }
public Uri UrlReferrer { get; }
member this.UrlReferrer : Uri
Public ReadOnly Property UrlReferrer As Uri

Eigenschaftswert

Uri

Ein Uri-Objekt, das den Text des Referer-Headers der Anforderung enthält, oder null, wenn der Header nicht in die Anforderung eingefügt wurde.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.

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

Hinweise

Wenn ein Client einem Link zum angeforderten URI gefolgt ist, enthält seine Anforderung möglicherweise einen Referrer Header, der den URI der Ressource identifiziert, die den Link enthält.

Clients können einen Header verfälschen oder nicht präsentieren Referer . Daher kann die UrlReferrer Eigenschaft zwar nützlich sein, um grundlegende Trends im Webdatenverkehr zu identifizieren, sie sollte jedoch nicht als Teil eines Autorisierungsschemas zum Steuern des Zugriffs auf Daten verwendet werden.

Eine vollständige Liste der Anforderungsheader finden Sie in der HttpRequestHeader Enumeration.

ist UrlReferrer NULL, wenn in der Anforderung kein Referrer Header vorhanden ist oder wenn der Referrer Header in der Anforderung vorhanden ist, aber nicht auf einen gültigen Urianalysiert wird.

Gilt für:

Weitere Informationen