readonly（C# 參考）

readonly 關鍵字是可以在字段上使用的修飾符。   當字段聲明包括 readonly 修飾符時，該聲明引入的字段賦值只能作為聲明的一部分出現，或者出現在同一類的構造函數中。

示例 

 

 

在此示例中，字段 year 的值無法在 ChangeYear 方法中更改，即使在類構造函數中給它賦了值。

C#

 

    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;

C#

 

    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

這與嘗試將值賦給常數時收到的錯誤相同。