readonly（C# 參考） · MSDN C# 編程指南 & 參考手冊 2015

# 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](https://msdn.microsoft.com/zh-cn/library/t3c3bfhx.aspx) 或 [ref](https://msdn.microsoft.com/zh-cn/library/14akc2c7.aspx) 參數傳遞才有效。 | ![](https://box.kancloud.cn/2016-01-31_56adb62c1380a.jpg) 注意 | | :-- | | **readonly** 關鍵字與 [const](https://msdn.microsoft.com/zh-cn/library/e6w8fe1b.aspx) 關鍵字不同。 **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# 語言規范](https://msdn.microsoft.com/zh-cn/library/ms228593.aspx)。該語言規范是 C# 語法和用法的權威資料。 ## 請參閱 [C# 參考](https://msdn.microsoft.com/zh-cn/library/618ayhy6.aspx) [C# 編程指南](https://msdn.microsoft.com/zh-cn/library/67ef8sbd.aspx) [C# 關鍵字](https://msdn.microsoft.com/zh-cn/library/x53a06bb.aspx) [修飾符（C# 參考）](https://msdn.microsoft.com/zh-cn/library/6tcf2h8w.aspx) [const（C# 參考）](https://msdn.microsoft.com/zh-cn/library/e6w8fe1b.aspx) [字段（C# 編程指南）](https://msdn.microsoft.com/zh-cn/library/ms173118.aspx)