TsgcTCPClient › Properties

TsgcTCPClient Properties

Published properties grouped by purpose, followed by the full alphabetical list.

Connection

NameDescription
ActiveOpens or closes the raw TCP connection to the configured server.
HostIP address or DNS name of the TCP server the client will connect to.
PortTCP port used to connect to the remote server.
TLSEnables a secure TLS/SSL connection to the TCP server.
IPVersionSelects the IP protocol version (IPv4 or IPv6) used for the TCP connection.
ProxyRoutes the TCP connection through an HTTP or SOCKS proxy server.

Binding

NameDescription
BoundIPLocal IP address the client socket is bound to before connecting.
BoundPortLocal TCP port the client socket is bound to before connecting.
BoundPortMinLower bound of the local port range when binding the outbound connection to a range of ports.
BoundPortMaxUpper bound of the local port range when binding the outbound connection to a range of ports.

Timeouts

NameDescription
ConnectTimeoutMaximum time in milliseconds the client waits for the TCP connection to be established.
ReadTimeoutMaximum time in milliseconds the client waits for incoming data before raising a read timeout.
WriteTimeoutMaximum duration in milliseconds for sending data to the other peer.

Socket

NameDescription
UseNagleEnables or disables Nagle's algorithm (TCP_NODELAY) on the client socket.
LingerStateConfigures the SO_LINGER socket option used when the client closes the connection.
TCPKeepAliveEnables OS-level TCP keep-alive probes on the client socket.

Reliability

NameDescription
HeartBeatTriggers a periodic application-level heartbeat to keep the connection alive and detect stalls.
WatchDogAutomatically reconnects to the server after an unexpected disconnection.
ThrottleLimits the number of bits per second sent or received by the client socket.

Security

NameDescription
TLSOptionsConfigures certificates, TLS version, ALPN, IOHandler and other secure-connection details used when TLS is enabled.

Advanced

NameDescription
QueueOptionsQueues outgoing text, binary and ping messages so they are serialised on the connection thread.
NotifyEventsControls how connection events are dispatched to the main thread.

Diagnostics

NameDescription
LogFilePersists inbound and outbound socket traffic to a file, useful for debugging the wire protocol.

All Properties (alphabetical)

NameDescription
ActiveOpens or closes the raw TCP connection to the configured server.
BoundIPLocal IP address the client socket is bound to before connecting.
BoundPortLocal TCP port the client socket is bound to before connecting.
BoundPortMaxUpper bound of the local port range when binding the outbound connection to a range of ports.
BoundPortMinLower bound of the local port range when binding the outbound connection to a range of ports.
ConnectTimeoutMaximum time in milliseconds the client waits for the TCP connection to be established.
HeartBeatTriggers a periodic application-level heartbeat to keep the connection alive and detect stalls.
HostIP address or DNS name of the TCP server the client will connect to.
IPVersionSelects the IP protocol version (IPv4 or IPv6) used for the TCP connection.
LingerStateConfigures the SO_LINGER socket option used when the client closes the connection.
LogFilePersists inbound and outbound socket traffic to a file, useful for debugging the wire protocol.
NotifyEventsControls how connection events are dispatched to the main thread.
PortTCP port used to connect to the remote server.
ProxyRoutes the TCP connection through an HTTP or SOCKS proxy server.
QueueOptionsQueues outgoing text, binary and ping messages so they are serialised on the connection thread.
ReadTimeoutMaximum time in milliseconds the client waits for incoming data before raising a read timeout.
TCPKeepAliveEnables OS-level TCP keep-alive probes on the client socket.
ThrottleLimits the number of bits per second sent or received by the client socket.
TLSEnables a secure TLS/SSL connection to the TCP server.
TLSOptionsConfigures certificates, TLS version, ALPN, IOHandler and other secure-connection details used when TLS is enabled.
UseNagleEnables or disables Nagle's algorithm (TCP_NODELAY) on the client socket.
WatchDogAutomatically reconnects to the server after an unexpected disconnection.
WriteTimeoutMaximum duration in milliseconds for sending data to the other peer.