Search code examples
c#propertiesreadonly

How to implement a read only property


I need to implement a read only property on my type. Moreover the value of this property is going to be set in the constructor and it is not going to be changed (I am writing a class that exposes custom routed UI commands for WPF but it does not matter).

I see two ways to do it:

  1. class MyClass
    {
        public readonly object MyProperty = new object();
    }
    
  2. class MyClass
    {
        private readonly object my_property = new object();
        public object MyProperty { get { return my_property; } }
    }
    

With all these FxCop errors saying that I should not have public member variables, it seems that the second one is the right way to do it. Is this correct?

Is there any difference between a get only property and a read only member in this case?


Solution

  • C# 6.0 adds readonly auto properties

    public object MyProperty { get; }
    

    So when you don't need to support older compilers you can have a truly readonly property with code that's just as concise as a readonly field.


    Versioning:
    I think it doesn't make much difference if you are only interested in source compatibility.
    Using a property is better for binary compatibility since you can replace it by a property which has a setter without breaking compiled code depending on your library.

    Convention:
    You are following the convention. In cases like this where the differences between the two possibilities are relatively minor following the convention is better. One case where it might come back to bite you is reflection based code. It might only accept properties and not fields, for example a property editor/viewer.

    Serialization
    Changing from field to property will probably break a lot of serializers. And AFAIK XmlSerializer does only serialize public properties and not public fields.

    Using an Autoproperty
    Another common Variation is using an autoproperty with a private setter. While this is short and a property it doesn't enforce the readonlyness. So I prefer the other ones.

    Readonly field is selfdocumenting
    There is one advantage of the field though:
    It makes it clear at a glance at the public interface that it's actually immutable (barring reflection). Whereas in case of a property you can only see that you cannot change it, so you'd have to refer to the documentation or implementation.

    But to be honest I use the first one quite often in application code since I'm lazy. In libraries I'm typically more thorough and follow the convention.