Parity Enumeration

Parity Enumeration

 

Specifies the parity bit for a SerialPort object.

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

public enum Parity

Member nameDescription
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.

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.

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.

// Display PortParity values and prompt user to enter a value.
public static Parity SetPortParity(Parity defaultPortParity)
{
    string parity;

    Console.WriteLine("Available Parity options:");
    foreach (string s in Enum.GetNames(typeof(Parity)))
    {
        Console.WriteLine("   {0}", s);
    }

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

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

    return (Parity)Enum.Parse(typeof(Parity), parity, true);
}

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