PowerTCP Mail for .NET
Connect(String,String) Method
See Also  Example Send comments on this topic.
Dart.PowerTCP.Mail Namespace > Tcp Class > Connect Method : Connect(String,String) Method




server
Remote hostname or address in dot notation.
serverPort
A string value which can be cast to an Integer between 1 and 65535, inclusive.
Connect to a host.

Syntax

Visual Basic (Declaration) 
<DescriptionAttribute("Connect to a server.")>
Public Overloads Sub Connect( _
   ByVal server As String, _
   ByVal serverPort As String _
) 
Visual Basic (Usage)Copy Code
Dim instance As Tcp
Dim server As String
Dim serverPort As String
 
instance.Connect(server, serverPort)
C# 
[DescriptionAttribute("Connect to a server.")]
public void Connect( 
   string server,
   string serverPort
)
Managed Extensions for C++ 
[DescriptionAttribute("Connect to a server.")]
public: void Connect( 
   string* server,
   string* serverPort
) 
C++/CLI 
[DescriptionAttribute("Connect to a server.")]
public:
void Connect( 
   String^ server,
   String^ serverPort
) 

Parameters

server
Remote hostname or address in dot notation.
serverPort
A string value which can be cast to an Integer between 1 and 65535, inclusive.

Example

The following example demonstrates connecting to an echo port, sending data, receiving data, then closing the connection.
Visual BasicCopy Code
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#Copy Code
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
    */
}

Remarks

The Tcp.Connect method establishes a network connection between the default local network interface/port and the device identified by remote network address/port. If no exception is thrown, the connection has succeeded and the Tcp.Connected property will return true after this method returns. Once the connection has been made, you can send/receive data to/from the server.

This method always blocks until the attempted connection succeeds or fails.

Requirements

Target Platforms: Microsoft .NET Framework 2.0

See Also

Documentation Version 3.2
© 2010 Dart Communications. All Rights Reserved.