|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Overloadable Operators (C# Programming Guide)
C# allows user-defined types to overload operators by defining static member functions using the operator keyword. Not all operators can be overloaded, however, and others have restrictions, as listed in this table:
These unary operators can be overloaded.
These binary operators can be overloaded.
The comparison operators can be overloaded (but see the note that follows this table).
The conditional logical operators cannot be overloaded, but they are evaluated using & and |, which can be overloaded.
The array indexing operator cannot be overloaded, but you can define indexers.
Assignment operators cannot be overloaded, but +=, for example, is evaluated using +, which can be overloaded.
These operators cannot be overloaded.
The comparison operators, if overloaded, must be overloaded in pairs; that is, if == is overloaded, != must also be overloaded. The reverse is also true, and similar for < and >, and for <= and >=.
To overload an operator on a custom class requires creating a method on the class with the correct signature. The method must be named "operator X" where X is the name or symbol of the operator being overloaded. Unary operators have one parameter, and binary operators have two parameters. In each case, one parameter must be the same type as the class or struct that declares the operator, as demonstrated in the following example:
For more information, see How to: Use Operator Overloading to Create a Complex Number Class (C# Programming Guide).