HttpWebRequest.ProtocolVersion Property

 

Gets or sets the version of HTTP to use for the request.

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

Public Property ProtocolVersion As Version

Property Value

Type: System.Version

The HTTP version to use for the request. The default is HttpVersion.Version11.

Exception Condition
ArgumentException

The HTTP version is set to a value other than 1.0 or 1.1.

The HttpWebRequest class supports only versions 1.0 and 1.1 of HTTP. Setting ProtocolVersion to a different version throws an exception.

System_CAPS_noteNote

To set the HTTP version of the current request, use the Version10 and Version11 fields of the HttpVersion class.

The following code example sets the ProtocolVersion Property.

' Create a new 'HttpWebRequest' Object to the mentioned URL.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.microsoft.com"), HttpWebRequest)
' Use the existing 'ProtocolVersion' , and display it onto the console.	
Console.WriteLine(ControlChars.Cr + "The 'ProtocolVersion' of the protocol used is {0}", myHttpWebRequest.ProtocolVersion)
' Set the 'ProtocolVersion' property of the 'HttpWebRequest' to 'Version1.0' .
myHttpWebRequest.ProtocolVersion = HttpVersion.Version10
'  Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine(ControlChars.Cr + "The 'ProtocolVersion' of the protocol changed to {0}", myHttpWebRequest.ProtocolVersion)
Console.WriteLine(ControlChars.Cr + "The protocol version of the response object is {0}", myHttpWebResponse.ProtocolVersion)

.NET Framework
Available since 1.1
Return to top
Show: