Connection Property

HttpWebRequest.Connection Property

 

Gets or sets the value of the Connection HTTP header.

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

member Connection : string with get, set

Property Value

Type: System.String

The value of the Connection HTTP header. The default value is null.

Exception Condition
ArgumentException

The value of Connection is set to Keep-alive or Close.

The request sends the Connection property to the Internet resource as the Connection HTTP header. If the value of the KeepAlive property is true, the value "Keep-alive" is appended to the end of the Connection header.

To clear the Connection HTTP header, set the Connection property to null.

Changing the Connection property after the request has been started by calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method throws an InvalidOperationException.

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 uses the Connection property to set the value of the Connection HTTP Header.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft