readonly (Справочник по C#)

Ключевое слово readonly — это модификатор, который можно использовать для полей. Если объявление поля содержит модификатор readonly, присвоение значений таким полям может происходить только как часть объявления или в конструкторе в том же классе.

Пример

Например, значение поля year нельзя изменить в методе ChangeYear несмотря на то, что в конструкторе класса ему присваивается значение:

    class Age
    {
        readonly int _year;
        Age(int year)
        {
            _year = year;
        }
        void ChangeYear()
        {
            //_year = 1967; // Compile error if uncommented.
        }
    }

Можно присвоить значение полю readonly только в следующих контекстах:

  • Когда переменная инициализируется в объявлении, например:

    public readonly int y = 5;
    
  • Для поля экземпляра — в конструкторах экземпляров класса, содержащего объявление поля, или, для статического поля — в статическом конструкторе класса, содержащего объявление поля. Это единственно возможные контексты, в которых можно передавать поле readonly в качестве параметра out или ref.

Примечание

Ключевое слов readonly отличается от ключевого слова const.Поле с модификатором const может быть инициализировано только при объявлении поля.Поле с модификатором readonly может быть инициализировано при объявлении или в конструкторе.Следовательно, поля с модификатором readonly могут иметь различные значения в зависимости от использованного конструктора.Кроме того, поле const является константой во время компиляции, а поле readonly можно использовать для констант времени выполнения, как показано в следующем примере:

public static readonly uint timeStamp = (uint)DateTime.Now.Ticks;
    public class ReadOnlyTest
    {
       class SampleClass
       {
          public int x;
          // Initialize a readonly field 
          public readonly int y = 25;
          public readonly int z;

          public SampleClass()
          {
             // Initialize a readonly instance field
             z = 24;
          }

          public SampleClass(int p1, int p2, int p3)
          {
             x = p1;
             y = p2;
             z = p3;
          }
       }

       static void Main()
       {
          SampleClass p1 = new SampleClass(11, 21, 32);   // OK
          Console.WriteLine("p1: x={0}, y={1}, z={2}", p1.x, p1.y, p1.z);
          SampleClass p2 = new SampleClass();
          p2.x = 55;   // OK
          Console.WriteLine("p2: x={0}, y={1}, z={2}", p2.x, p2.y, p2.z);
       }
    }
    /*
     Output:
        p1: x=11, y=21, z=32
        p2: x=55, y=25, z=24
    */

В предыдущем примере при использовании такого оператора:

p2.y = 66; // Error

будет отображено сообщение об ошибке компилятора:

The left-hand side of an assignment must be an l-value

Это такая же ошибка, которая возникает при попытке присвоить значение константе.

Спецификация языка C#

Дополнительные сведения см. в Спецификация языка C#. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.

См. также

Ссылки

Ключевые слова C#

Модификаторы (Справочник по C#)

const (Справочник по C#)

Поля (Руководство по программированию в C#)

Основные понятия

Руководство по программированию на C#

Другие ресурсы

Справочник по C#