Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Handshake Enumeration

 

Specifies the control protocol used in establishing a serial port communication for a SerialPort object.

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

public enum class Handshake

Member nameDescription
None

No control is used for the handshake.

RequestToSend

Request-to-Send (RTS) hardware flow control is used. RTS signals that data is available for transmission. If the input buffer becomes full, the RTS line will be set to false. The RTS line will be set to true when more room becomes available in the input buffer.

RequestToSendXOnXOff

Both the Request-to-Send (RTS) hardware control and the XON/XOFF software controls are used.

XOnXOff

The XON/XOFF software control protocol is used. The XOFF control is sent to stop the transmission of data. The XON control is sent to resume the transmission. These software controls are used instead of Request to Send (RTS) and Clear to Send (CTS) hardware controls.

This enumeration is used with the Handshake property.

The following code example displays the possible values of the Handshake enumeration to the console, then prompts the user to choose one. This code example is part of a larger code example provided for the SerialPort class.

static Handshake SetPortHandshake(Handshake defaultPortHandshake)
{
    String^ handshake;

    Console::WriteLine("Available Handshake options:");
    for each (String^ s in Enum::GetNames(Handshake::typeid))
    {
        Console::WriteLine("   {0}", s);
    }

    Console::Write("Enter Handshake value (Default: {0}):", defaultPortHandshake.ToString());
    handshake = Console::ReadLine();

    if (handshake == "")
    {
        handshake = defaultPortHandshake.ToString();
    }

    return (Handshake)Enum::Parse(Handshake::typeid, handshake);
}

.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft