DataToSend Property

A string of data to be sent to the remote host.

Syntax

public void setDataToSend(byte [] dataToSend);

Remarks

Assigning a string to this property makes the bean send the string to the remote host. The Send method provides similar functionality.

When Timeout is set to a positive value (default) the beanwill behave synchronously. The bean will not return control until all data has been delivered or an error is encountered.

When Timeout is set to 0 the bean will behave asynchronously. The bean will return control immediately. If data is being sent quickly and more than MaxOutgoingOutstandingCount packets are unacknowledged DataToSend will fail with a "Wouldblock" exception. When this exception occurs the BytesSent property holds the number of bytes that were sent (if any). Monitor the ReadyToSend event to determine when sending can resume. Resend the data which previously caused the exception after ReadyToSend fires.

This property is write-only and not available at design time.

Default Value

""