See Also

Tcp Class  | Tcp Members  | Overload List

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Language

Visual Basic

C#

C++

C++/CLI

Show All

linger
If null is used, a graceful disconnect will occur without blocking execution of your application.
See Also Languages PowerTCP SSL Sockets for .NET

Close(LingerOption) Method

Dart.PowerTCP.SslSockets Namespace > Tcp Class > Close Method : Close(LingerOption) Method

Close the connection.

[Visual Basic]
<DescriptionAttribute("Close the connection.")> Overloads Public Sub Close( _    ByVal linger As LingerOption _ )
[C#]
[DescriptionAttribute("Close the connection.")] public void Close(    LingerOption linger );
[C++]
[DescriptionAttribute("Close the connection.")] public: void Close(    LingerOption* linger )
[C++/CLI]
[DescriptionAttribute("Close the connection.")] public: void Close(    LingerOption^ linger )

Parameters

linger
If null is used, a graceful disconnect will occur without blocking execution of your application.

Remarks

This method is the recommended way to explicitly close a connection. The Connected property is set to false when the connection is closed.

The LingerOption parameter controls the amount of time to remain connected after the socket is closed.

Example

The following example demonstrates connecting to an echo port, sending data, receiving data, then closing the connection.

[Visual Basic] 

Private Sub TcpDemo()

   ' Connect to echo port.
   Tcp1.Connect("atropos", "7")

   ' Send some data
   Dim seg As Segment = Tcp1.Send("Hello")

   ' Display info
   Debug.WriteLine("Bytes of data sent: " & seg.Count)
   Debug.WriteLine("Data sent: " & seg.ToString())

   ' Receive response (this should be the same as the sent data)
   seg = Tcp1.Receive()

   ' Display info
   Debug.WriteLine("Bytes of data received: " & seg.Count)
   Debug.WriteLine("Data received: " & seg.ToString())

   ' Since connection is to an echo port, the client has to
   ' close the connection.
   Try
      Tcp1.Close()
   Catch ex As Exception
      ' Error, just dispose the object.
      Tcp1.Dispose()
   End Try

   '* Output
   '* --------------------------
   '* Bytes of data sent: 5
   '* Data sent: Hello
   '* Bytes of data received: 5
   '* Data received: Hello
   '*
End Sub

[C#] 


private void TcpDemo()
{
  
// Connect to echo port.
  
tcp1.Connect("atropos", "7");

  
// Send some data
  
Segment seg = tcp1.Send("Hello");

  
// Display info
  
Debug.WriteLine("Bytes of data sent: " + seg.Count);
  Debug.WriteLine(
"Data sent: " + seg.ToString());

  
// Receive response (this should be the same as the sent data)
  
seg = tcp1.Receive();

  
// Display info
  
Debug.WriteLine("Bytes of data received: " + seg.Count);
  Debug.WriteLine(
"Data received: " + seg.ToString());

  
// Since connection is to an echo port, the client has to
  
// close the connection.
  
try
  {
     
tcp1.Close();
  }
  
catch(Exception ex)
  {
     
// Error, just dispose the object.
     
tcp1.Dispose();
  }

  
/* Output
   * --------------------------
   * Bytes of data sent: 5
   * Data sent: Hello
   * Bytes of data received: 5
   * Data received: Hello
   */
}
                

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Tcp Class  | Tcp Members  | Overload List


Send comments on this topic.

Documentation version 1.1.2.0.

© 2008 Dart Communications.  All rights reserved.