Прочитать на английском

Поделиться через


ServicePoint.ConnectionLeaseTimeout Свойство

Определение

Возвращает или задает количество миллисекунда, после которого закрывается активное ServicePoint подключение.

public int ConnectionLeaseTimeout { get; set; }

Значение свойства

Int32, указывающий количество миллисекунда, которое активное подключение ServicePoint остается открытым. Значение по умолчанию — -1, что позволяет активному ServicePoint подключению оставаться на неопределенный срок. Задайте для этого свойства значение 0, чтобы принудительно ServicePoint подключения закрываться после обслуживания запроса.

Исключения

Значение, указанное для операции набора, является отрицательным числом меньше -1.

Примеры

В следующем примере кода задается значение этого свойства.

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();
        }
    }
}

Комментарии

Внимание!

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Это свойство можно использовать, чтобы убедиться, что активные подключения объекта ServicePoint не остаются открытыми на неопределенный срок. Это свойство предназначено для сценариев, когда подключения должны быть удалены и повторно удалены периодически, например сценарии балансировки нагрузки.

По умолчанию, если KeepAlivetrue для запроса, свойство MaxIdleTime задает время ожидания для закрытия ServicePoint подключений из-за бездействия. Если ServicePoint имеет активные подключения, MaxIdleTime не действует, и подключения остаются открытыми на неопределенный срок.

Если свойство ConnectionLeaseTimeout имеет значение, отличное от -1, и по истечении указанного времени, активное ServicePoint подключение закрывается после обслуживания запроса, задав KeepAlive значение false в этом запросе.

Установка этого значения влияет на все подключения, управляемые объектом ServicePoint.

Применяется к

Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

См. также раздел