ServicePoint.ConnectionLeaseTimeout Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.ServicePoint.dll

Исходный код:

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

Значение, указанное для операции задания, является отрицательным числом меньше -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 подключения объекта не остаются открытыми на неопределенный срок. Это свойство предназначено для сценариев, в которых подключения следует периодически удалять и повторно устанавливать, например для сценариев балансировки нагрузки.

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

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

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

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

• KeepAlive
• KeepAlive
• KeepAlive