Send data to the server.

Syntax

Visual Basic (Declaration)
<DescriptionAttribute("Converts a string into a byte array and sends it.")> Public Overloads Function Send( _ ByVal buffer As String _ ) As Segment

Visual Basic (Usage)	Copy Code
Dim instance As Tcp Dim buffer As String Dim value As Segment value = instance.Send(buffer)

C#
[DescriptionAttribute("Converts a string into a byte array and sends it.")] public Segment Send( string buffer )

Managed Extensions for C++
[DescriptionAttribute("Converts a string into a byte array and sends it.")] public: Segment* Send( string* buffer )

C++/CLI
[DescriptionAttribute("Converts a string into a byte array and sends it.")] public: Segment^ Send( String^ buffer )

Parameters

buffer: Data to be decoded into bytes and sent.

Return Value

A Segment object encapsulating information about the data sent.

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	offset or count is less than 0.
System.ArgumentException	offset + count is greater than the length of buffer.
System.Net.Sockets.SocketException	The socket is not connected.

Example

The following example demonstrates blocking operations using the Tcp component.

Visual Basic	Copy Code
Private Sub TcpDemo() ' The following code assumes that good responses are always received from ' the server. More robust code should check each response and handle appropriately. ' Connect to Echo Server Tcp1.Connect("myEchoServer", 7) ' Send some data Tcp1.Send("Hello Server!" + vbCrLf) ' Get response from the server Dim seg As Segment = Tcp1.Receive() Debug.WriteLine(seg.ToString()) ' Send more data Tcp1.Send("You are a swell host" + vbCrLf) ' Get response from the server seg = Tcp1.Receive() Debug.WriteLine(seg.ToString()) 'Close the connection Tcp1.Close() End Sub

Visual Basic

Copy Code

Private Sub TcpDemo()
   ' The following code assumes that good responses are always received from
   ' the server. More robust code should check each response and handle appropriately.

   ' Connect to Echo Server
   Tcp1.Connect("myEchoServer", 7)

   ' Send some data
   Tcp1.Send("Hello Server!" + vbCrLf)

   ' Get response from the server
   Dim seg As Segment = Tcp1.Receive()
   Debug.WriteLine(seg.ToString())

   ' Send more data
   Tcp1.Send("You are a swell host" + vbCrLf)

   ' Get response from the server
   seg = Tcp1.Receive()
   Debug.WriteLine(seg.ToString())
   
   'Close the connection
   Tcp1.Close()
End Sub

C#	Copy Code
private void TcpDemo() { // The following code assumes that good responses are always received from // the server. More robust code should check each response and handle appropriately. // Connect to Echo Server tcp1.Connect("myEchoServer", 7); // Send some data tcp1.Send("Hello Server!\r\n"); // Get response from the server Segment seg = tcp1.Receive(); Debug.WriteLine(seg.ToString()); // Send more data tcp1.Send("You are a swell host\r\n"); // Get response from the server seg = tcp1.Receive(); Debug.WriteLine(seg.ToString()); //Close the connection tcp1.Close(); }

Copy Code

private void TcpDemo()
{
   // The following code assumes that good responses are always received from
   // the server. More robust code should check each response and handle appropriately.

   // Connect to Echo Server
   tcp1.Connect("myEchoServer", 7);

   // Send some data
   tcp1.Send("Hello Server!\r\n");

   // Get response from the server
   Segment seg = tcp1.Receive();
   Debug.WriteLine(seg.ToString());

   // Send more data
   tcp1.Send("You are a swell host\r\n");

   // Get response from the server
   seg = tcp1.Receive();
   Debug.WriteLine(seg.ToString());
   
   //Close the connection
   tcp1.Close();
}

Remarks

After connecting, data can be received using the Tcp.Send method. All Tcp.Send methods return a Segment object, encapsulating information about the data sent such as the data sent, and the amount of bytes of data sent.

This method is functionally equivalent to Tcp.Stream.Write.

Requirements

Target Platforms: Microsoft .NET Framework 2.0