HttpWebRequest::UserAgent Property

 

Gets or sets the value of the User-agent HTTP header.

Namespace:   System.Net
Assembly:  System (in System.dll)

public:
property String^ UserAgent {
	String^ get();
	void set(String^ value);
}

Property Value

Type: System::String^

The value of the User-agent HTTP header. The default value is null.

System_CAPS_noteNote

The value for this property is stored in WebHeaderCollection. If WebHeaderCollection is set, the property value is lost.

The following code example sets the UserAgent property.

// Create a new 'HttpWebRequest' object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->UserAgent = ".NET Framework Test Client";
// 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 = gcnew StreamReader( streamResponse );
array<Char>^ readBuff = gcnew array<Char>(256);
int count = streamRead->Read( readBuff, 0, 256 );
Console::WriteLine( "\nThe contents of HTML Page are :\n" );
while ( count > 0 )
{
   String^ outputData = gcnew String( readBuff,0,count );
   Console::Write( outputData );
   count = streamRead->Read( readBuff, 0, 256 );
}
streamRead->Close();
streamResponse->Close();
myHttpWebResponse->Close();

.NET Framework
Available since 1.1
Silverlight
Available since 5.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: