Export (0) Print
Expand All

HttpWebRequest.Referer Property

Gets or sets the value of the Referer HTTP header.

[Visual Basic]
Public Property Referer As String
[C#]
public string Referer {get; set;}
[C++]
public: __property String* get_Referer();
public: __property void set_Referer(String*);
[JScript]
public function get Referer() : String;
public function set Referer(String);

Property Value

The value of the Referer HTTP header. The default value is a null reference (Nothing in Visual Basic).

Remarks

If the AllowAutoRedirect property is true, the Referer property is set automatically when the request is redirected to another site.

To clear the Referer HTTP header, set the Referer property to a null reference (Nothing in Visual Basic).

Example

[Visual Basic, C#, C++] The following example sets the Referer property.

[Visual Basic] 
' Create a 'HttpWebRequest' object.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(myUri), HttpWebRequest)
' Referer property is set to http://www.microsoft.com
myHttpWebRequest.Referer = "http://www.microsoft.com"
' The response object of 'HttpWebRequest' is assigned to a 'HttpWebResponse' variable.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
' Displaying the contents of the page to the console
Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
Dim streamRead As New StreamReader(streamResponse)
Dim readBuffer(256) As [Char]
Dim count As Integer = streamRead.Read(readBuffer, 0, 256)
Console.WriteLine(ControlChars.Cr + "The contents of HTML page are.......")
While count > 0
    Dim outputData As New [String](readBuffer, 0, count)
    Console.Write(outputData)
    count = streamRead.Read(readBuffer, 0, 256)
End While
Console.WriteLine(ControlChars.Cr + "HTTP Request  Headers :" + ControlChars.Cr + ControlChars.Cr + "{0}", myHttpWebRequest.Headers)
Console.WriteLine(ControlChars.Cr + "HTTP Response Headers :" + ControlChars.Cr + ControlChars.Cr + "{0}", myHttpWebResponse.Headers)
' Release the response object resources.
streamRead.Close()
 streamResponse.Close()
myHttpWebResponse.Close()
Console.WriteLine("Referer to the site is:{0}", myHttpWebRequest.Referer)

[C#] 
// Create a 'HttpWebRequest' object.
HttpWebRequest    myHttpWebRequest=(HttpWebRequest)WebRequest.Create(myUri);
// Set referer property  to http://www.microsoft.com .
myHttpWebRequest.Referer="http://www.microsoft.com";
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
// Display the contents of the page to the console.
Stream streamResponse=myHttpWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader( streamResponse );
Char[] readBuffer = new Char[256];
int count = streamRead.Read( readBuffer, 0, 256 );
Console.WriteLine("\nThe contents of HTML page are.......");    
while (count > 0) 
{
    String outputData = new String(readBuffer, 0, count);
    Console.Write(outputData);
    count = streamRead.Read(readBuffer, 0, 256);
}
Console.WriteLine("\nHTTP Request  Headers :\n\n{0}",myHttpWebRequest.Headers);
Console.WriteLine("\nHTTP Response Headers :\n\n{0}",myHttpWebResponse.Headers);    
streamRead.Close();
streamResponse.Close();
// Release the response object resources.
myHttpWebResponse.Close();
Console.WriteLine("Referer to the site is:{0}",myHttpWebRequest.Referer);    

[C++] 
// Create a 'HttpWebRequest' object.
HttpWebRequest* myHttpWebRequest =
   dynamic_cast<HttpWebRequest*>(WebRequest::Create(myUri));
// Set referer property  to http://www.microsoft.com .
myHttpWebRequest->Referer=S"http://www.microsoft.com";
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse* myHttpWebResponse =
   dynamic_cast<HttpWebResponse*>(myHttpWebRequest->GetResponse());
// Display the contents of the page to the console.
Stream* streamResponse =
   myHttpWebResponse->GetResponseStream();
StreamReader* streamRead = new StreamReader(streamResponse);
Char readBuffer[] = new Char[256];
int count = streamRead->Read(readBuffer, 0, 256);
Console::WriteLine(S"\nThe contents of HTML page are.......");
while (count > 0) {
   String* outputData = new String(readBuffer, 0, count);
   Console::Write(outputData);
   count = streamRead->Read(readBuffer, 0, 256);
}
Console::WriteLine(S"\nHTTP Request  Headers :\n\n {0}",
   myHttpWebRequest->Headers);
Console::WriteLine(S"\nHTTP Response Headers :\n\n {0}",
   myHttpWebResponse->Headers);
streamRead->Close();
streamResponse->Close();
// Release the response object resources.
myHttpWebResponse->Close();
Console::WriteLine(S"Referer to the site is: {0}",
   myHttpWebRequest->Referer);

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

HttpWebRequest Class | HttpWebRequest Members | System.Net Namespace

Show:
© 2014 Microsoft