| 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.
The following example demonstrates connecting to an echo port, sending data, receiving data, then closing the connection.
| Visual Basic | Copy 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 */ } | |
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.
Target Platforms: Microsoft .NET Framework 2.0