SerialPort.DtrEnable Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value that enables the Data Terminal Ready (DTR) signal during serial communication.

Namespace: System.IO.Ports
Assembly: System (in system.dll)

public bool DtrEnable { get; set; }
/** @property */
public boolean get_DtrEnable ()

/** @property */
public void set_DtrEnable (boolean value)

public function get DtrEnable () : boolean

public function set DtrEnable (value : boolean)

Property Value

true to enable Data Terminal Ready (DTR); otherwise, false. The default is false.

Exception typeCondition


The port is in an invalid state.

- or -

An attempt to set the state of the underlying port failed. For example, the parameters passed from this SerialPort object were invalid.

Data Terminal Ready (DTR) is typically enabled during XON/XOFF software handshaking and Request to Send/Clear to Send (RTS/CTS) hardware handshaking, and modem communications.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0

Community Additions