HttpWebRequest.UserAgent Property

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

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

'Declaration
Public Property UserAgent As String

Property Value

Type: System.String
The value of the User-agent HTTP header. The default value is Nothing.
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. 
            Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), 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)
                Console.Write(outputData)
                count = streamRead.Read(readBuff, 0, 256)
            End While
            streamRead.Close()
	         streamResponse.Close()    
          ' Release the response object resources.
	         myHttpWebResponse.Close()

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft