HttpWebRequest.UserAgent Property


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

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

Public Property UserAgent As String

Property Value

Type: System.String

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


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.
  Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(""), HttpWebRequest)
  myHttpWebRequest.UserAgent= ".NET Framework Test Client"
  ' The response object of 'HttpWebRequest' is assigned to a 'HttpWebResponse' variable.
  Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
  ' Display the contents of the page to the console.
  Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
  Dim streamRead As New StreamReader(streamResponse)
  Dim readBuff(256) As [Char]
  Dim count As Integer = streamRead.Read(readBuff, 0, 256)
  Console.WriteLine(ControlChars.Cr + "The contents of HTML Page are :" + ControlChars.Cr)
  While count > 0
      Dim outputData As New [String](readBuff, 0, count)
      count = streamRead.Read(readBuff, 0, 256)
  End While
' Release the response object resources.

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