ServicePoint.ConnectionLeaseTimeout 属性

定义

命名空间:

System.Net

程序集:

System.Net.ServicePoint.dll

Source:

ServicePoint.cs

获取或设置在多少毫秒之后关闭活动 ServicePoint 连接。

public:
 property int ConnectionLeaseTimeout { int get(); void set(int value); };

public int ConnectionLeaseTimeout { get; set; }

member this.ConnectionLeaseTimeout : int with get, set

Public Property ConnectionLeaseTimeout As Integer

属性值

Int32

Int32，它指定活动 ServicePoint 连接保持打开的毫秒数。 默认值为 -1，这样活动 ServicePoint 连接可以无限期保持连接。 将此属性设置为 0 可在 ServicePoint 连接为请求提供服务之后强制关闭该连接。

例外

ArgumentOutOfRangeException

为 Set 操作指定的值为小于 -1 的负数。

示例

下面的代码示例设置此属性的值。

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::Sockets;
using namespace System::IO;
using namespace System::Threading;

namespace SystemNetExamples
{
    public ref class ServicePointExample
    {
    public:

        // Pass in the name of the Web page to retrieve.    
        static void PrintResponse(String^ page)
        {

            // Create the request.
            HttpWebRequest^ request;
            Uri^ uri;
            
 

            try
            {
                uri = gcnew Uri(page);
            }
            catch (UriFormatException^ ex) 
            {
                Console::WriteLine(ex->Message);
            }

            request = (HttpWebRequest^) WebRequest::Create(uri); 

            // Get the service point that handles the request's 
            // socket connection.
            ServicePoint^ point = request->ServicePoint;

            // Set the receive buffer size on the underlying socket.
            point->ReceiveBufferSize = 2048;

            // Set the connection lease timeout to infinite.
            point->ConnectionLeaseTimeout = Timeout::Infinite;

            // Send the request.
            HttpWebResponse^ response = 
                (HttpWebResponse^) request->GetResponse();
            Stream^ responseStream = response->GetResponseStream();
            StreamReader^ streamReader = 
                gcnew StreamReader(responseStream);
            try
            {
                // Display the response.
                Console::WriteLine(streamReader->ReadToEnd());
                responseStream->Close();
                response->Close();
            }
            finally
            {
                streamReader->Close();
            }
        }
    };
}

using System;
using System.Net;
using System.Net.Sockets;
using System.IO;
using System.Threading;

namespace Examples.System.Net
{
    public class ServicePointExample
    {
        // Pass in the name of the Web page to retrieve.
        public static void Main(string[] args)
        {
            string page;
            if (args == null || args.Length == 0 || args[0].Length == 0)
            {
                page = "http://www.contoso.com/default.html";
            }
            else
            {
                page = args[0];
            }
            // Create the request.
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(page);
            // Get the service point that handles the request's socket connection.
            ServicePoint point = request.ServicePoint;
            // Set the receive buffer size on the underlying socket.
            point.ReceiveBufferSize = 2048;
            // Set the connection lease timeout to infinite.
            point.ConnectionLeaseTimeout = Timeout.Infinite;
            // Send the request.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream responseStream = response.GetResponseStream();
            StreamReader s = new StreamReader(responseStream);
            // Display the response.
            Console.WriteLine(s.ReadToEnd());
            s.Close();
            responseStream.Close();
            response.Close();
        }
    }
}

Imports System.Net
Imports System.Net.Sockets
Imports System.IO
Imports System.Threading

Public Class ServicePointExample

    ' Pass in the name of the Web page to retrieve.
    Public Shared Sub Main(ByVal args() As String)
        Dim page As String
        If args Is Nothing OrElse args.Length = 0 OrElse args(0).Length = 0 Then
            page = "http://www.contoso.com/default.html"
        Else
            page = args(0)
        End If

        Dim request As HttpWebRequest = CType(WebRequest.Create(page), HttpWebRequest)
        ' Get the service point that handles the request's socket connection.
        Dim point As ServicePoint = request.ServicePoint
        ' Set the receive buffer size on the underlying socket.
        point.ReceiveBufferSize = 2048
        ' Set the connection lease timeout to infinite.
        point.ConnectionLeaseTimeout = Timeout.Infinite
        ' Send the request.
        Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
        Dim responseStream As Stream = response.GetResponseStream()
        Dim s As New StreamReader(responseStream)
        ' Display the response.
        Console.WriteLine(s.ReadToEnd())
        responseStream.Close()
        response.Close()
    End Sub
End Class

注解

可以使用此属性来确保 ServicePoint 对象的活动连接不会无限期保持打开状态。 此属性适用于应定期删除和重新建立连接的情况，例如负载均衡方案。

默认情况下，当 请求 为 时KeepAlivetrue，MaxIdleTime属性会设置由于非活动而关闭ServicePoint连接的超时。 ServicePoint如果 具有活动连接，MaxIdleTime则不起作用，并且连接将无限期保持打开状态。

当 属性 ConnectionLeaseTimeout 设置为 -1 以外的值时，在指定的时间过后，活动 ServicePoint 连接将在处理请求后关闭，方法是在该请求中将 设置为 KeepAlivefalse 。

设置此值会影响对象 ServicePoint 管理的所有连接。

另请参阅

• KeepAlive
• KeepAlive
• KeepAlive