ServicePoint.ConnectionLeaseTimeout Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.ServicePoint.dll

Sumber:

ServicePoint.cs

Mendapatkan atau mengatur jumlah milidetik setelah koneksi aktif ServicePoint ditutup.

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

Nilai Properti

Int32

Int32 yang menentukan jumlah milidetik bahwa koneksi aktif ServicePoint tetap terbuka. Defaultnya adalah -1, yang memungkinkan koneksi aktif ServicePoint untuk tetap terhubung tanpa batas waktu. Atur properti ini ke 0 untuk memaksa ServicePoint koneksi ditutup setelah melayani permintaan.

Pengecualian

ArgumentOutOfRangeException

Nilai yang ditentukan untuk operasi set adalah angka negatif kurang dari -1.

Contoh

Contoh kode berikut menetapkan nilai properti ini.

#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

Keterangan

Anda dapat menggunakan properti ini untuk memastikan bahwa ServicePoint koneksi aktif objek tidak tetap terbuka tanpa batas waktu. Properti ini ditujukan untuk skenario di mana koneksi harus dihilangkan dan dibangun kembali secara berkala, seperti skenario penyeimbangan beban.

Secara default, ketika KeepAlive adalah true untuk permintaan, MaxIdleTime properti mengatur waktu habis untuk menutup ServicePoint koneksi karena tidak aktif. ServicePoint Jika memiliki koneksi aktif, MaxIdleTime tidak berpengaruh dan koneksi tetap terbuka tanpa batas waktu.

ConnectionLeaseTimeout Ketika properti diatur ke nilai selain -1, dan setelah waktu yang ditentukan berlalu, koneksi aktif ServicePoint ditutup setelah melayani permintaan dengan mengatur KeepAlive ke false dalam permintaan tersebut.

Mengatur nilai ini memengaruhi semua koneksi yang dikelola oleh ServicePoint objek.

Lihat juga

• KeepAlive
• KeepAlive
• KeepAlive