Using Conversion Operators (C# Programming Guide)

http://msdn.microsoft.com/en-us/library/85w54y0a

Using Conversion Operators (C# Programming Guide)

Visual Studio 2010 3 out of 4 rated this helpful - Rate this topic Conversion operators can be explicit or implicit. Implicit conversion operators are easier to use, but explicit operators are useful when you want users of the operator to be aware that a conversion is taking place. This topic demonstrates both types.

Example
This is an example of an explicit conversion operator. This operator converts from the type Byte to a value type called Digit. Because not all bytes can be converted to a digit, the conversion is explicit, meaning that a cast must be used, as shown in the Main method.

struct Digit { byte value; public Digit(byte value) //constructor { if (value > 9) { throw new System.ArgumentException(); } this.value = value; } public static explicit operator Digit(byte b) // explicit byte to digit conversion operator { Digit d = new Digit(b); // explicit conversion System.Console.WriteLine("Conversion occurred."); return d;

class TestExplicitConversion { static void Main() { try { byte b = 3; Digit d = (Digit)b; // explicit conversion } catch (System.Exception e) { System.Console.WriteLine("{0} Exception caught.", e); } }

1 of 3

5/25/2012 11:42 AM

Using Conversion Operators (C# Programming Guide) } // Output: Conversion occurred.

http://msdn.microsoft.com/en-us/library/85w54y0a

This example demonstrates an implicit conversion operator by defining a conversion operator that undoes what the previous example did: it converts from a value class called Digit to the integral Byte type. Because any digit can be converted to a Byte, there's no need to force users to be explicit about the conversion.

struct Digit { byte value; public Digit(byte value) //constructor { if (value > 9) { throw new System.ArgumentException(); } this.value = value; } public static implicit operator byte(Digit d) // implicit digit to byte conversion operator { System.Console.WriteLine("conversion occurred"); return d.value; // implicit conversion }

class TestImplicitConversion { static void Main() { Digit d = new Digit(3); byte b = d; // implicit conversion -- no cast needed } } // Output: Conversion occurred.

See Also
Reference Conversion Operators (C# Programming Guide) is (C# Reference) Concepts C# Programming Guide Other Resources

2 of 3

5/25/2012 11:42 AM

Using Conversion Operators (C# Programming Guide) C# Reference

http://msdn.microsoft.com/en-us/library/85w54y0a

Did you find this helpful?

Yes

No

Community Content
2012 Microsoft. All rights reserved.

3 of 3

5/25/2012 11:42 AM