HttpListenerRequest.KeepAlive Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a Boolean value that indicates whether the client requests a persistent connection.
public:
property bool KeepAlive { bool get(); };
public bool KeepAlive { get; }
member this.KeepAlive : bool
Public ReadOnly Property KeepAlive As Boolean
Property Value
true
if the connection should be kept open; otherwise, false
.
Examples
The following code example demonstrates using this property.
public static void ShowRequestProperties2 (HttpListenerRequest request)
{
Console.WriteLine("KeepAlive: {0}", request.KeepAlive);
Console.WriteLine("Local end point: {0}", request.LocalEndPoint.ToString());
Console.WriteLine("Remote end point: {0}", request.RemoteEndPoint.ToString());
Console.WriteLine("Is local? {0}", request.IsLocal);
Console.WriteLine("HTTP method: {0}", request.HttpMethod);
Console.WriteLine("Protocol version: {0}", request.ProtocolVersion);
Console.WriteLine("Is authenticated: {0}", request.IsAuthenticated);
Console.WriteLine("Is secure: {0}", request.IsSecureConnection);
}
Public Shared Sub ShowRequestProperties2(ByVal request As HttpListenerRequest)
Console.WriteLine("KeepAlive: {0}", request.KeepAlive)
Console.WriteLine("Local end point: {0}", request.LocalEndPoint.ToString())
Console.WriteLine("Remote end point: {0}", request.RemoteEndPoint.ToString())
Console.WriteLine("Is local? {0}", request.IsLocal)
Console.WriteLine("HTTP method: {0}", request.HttpMethod)
Console.WriteLine("Protocol version: {0}", request.ProtocolVersion)
Console.WriteLine("Is authenticated: {0}", request.IsAuthenticated)
Console.WriteLine("Is secure: {0}", request.IsSecureConnection)
End Sub
Remarks
If an HTTP client and server expect to exchange data multiple times in a short time period, a persistent connection speeds up their communications by allowing them to avoid the overhead required to open and close a TCP connection for each message. For clients using HTTP/1.1, the default value for this property is true
.