Parity Enumeration

.NET Framework (current version)

Specifies the parity bit for a SerialPort object.

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

Syntax

public enum class Parity

Members

	Member name	Description
	Even	Sets the parity bit so that the count of bits set is an even number.
	Mark	Leaves the parity bit set to 1.
	None	No parity check occurs.
	Odd	Sets the parity bit so that the count of bits set is an odd number.
	Space	Leaves the parity bit set to 0.

Remarks

Use this enumeration when setting the Parity property for a serial port connection.

Parity is an error-checking procedure in which the number of 1s must always be the same—either even or odd—for each group of bits that is transmitted without error. In modem-to-modem communications, parity is often one of the parameters that must be agreed upon by sending parties and receiving parties before transmission can take place.

Examples

The following code example displays the possible values of the Parity 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.

C++

static Parity SetPortParity(Parity defaultPortParity)
{
    String^ parity;

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

    Console::Write("Enter Parity value (Default: {0}):", defaultPortParity.ToString());
    parity = Console::ReadLine();

    if (parity == "")
    {
        parity = defaultPortParity.ToString();
    }

    return (Parity)Enum::Parse(Parity::typeid, parity);
}

Version Information

.NET Framework
Available since 2.0