CodeGym /課程 /C# SELF /自動屬性與 init-only setter

自動屬性與 init-only setter

C# SELF
等級 17, 課堂 2
開放

1. 自動屬性

在 C# 裡,屬性(property)有點像欄位跟方法的混合體。其實它就是語法糖,讓你封裝資料變得超方便。你用起來就像直接用欄位一樣,但裡面可以塞任何邏輯:資料驗證、改其他欄位、呼叫方法,甚至寄 email 給你阿嬤(最後這個不建議啦)。上一堂課我們是手動寫屬性,但如果你有 100500 個超簡單的物件,只需要「getter」跟「setter」沒啥邏輯,這樣寫很快就膩了。

來了——自動屬性。它們幫你省掉重複碼,讓 C# 自己幫你存值,你不用管。

以前怎麼寫:手動屬性

如果你想把欄位藏起來,但又想讓外部可以透過屬性存取,通常會這樣寫:


public class Dog
{
    private string name;

    public string Name
    {
        get { return name; }
        set { name = value; }
    }
}
手動屬性 + private 欄位

這種寫法超「囉唆」(boilerplate)。而且通常我們根本不會在 get/set 裡加什麼東西!只是想讓外部能存取而已。

現在可以怎麼寫

C# 現在超簡單:不用自己寫欄位,編譯器會自動幫你搞定。你只要這樣寫:


public class Dog
{
    public string Name { get; set; }
}
自動屬性

就這樣搞定。你可以直接讀寫 Name,編譯器會自動在背後產生 private 欄位,外部根本碰不到。

那背後到底發生什麼事?當你寫 public string Name { get; set; },編譯器會自動產生一個隱藏欄位像 Name__BackingField。每次你用 Name,它就插入對應的 getter/setter。這個欄位你在程式裡看不到,但它真的存在——用 reflection 還找得到(但這又是另一個故事了)。

這種寫法有什麼爽點?第一,超短不用重複寫一堆。第二,程式碼乾淨多了:少了很多雜訊,超好讀也好維護。最後,更安全——沒人能直接亂動欄位,存取都要走屬性。

2. 自動屬性的語法

語法超簡單:


public class Dog
{
    public string Name { get; set; }
    public int Age { get; set; }
}
多個自動屬性

現在我們的 Dog 看起來超精簡!你可以這樣建立物件跟設定值:

Dog myDog = new Dog();
myDog.Name = "Барбос";
myDog.Age = 4;

圖解

方式 語法 值的存取
欄位
public string Name;
直接存取
手動屬性
public string Name { get; set; } + private string name;
透過 get/set
自動屬性
public string Name { get; set; }
get/set + 隱藏欄位

3. 存取權限客製化:唯讀、唯寫

唯讀:get-only

如果你只想讓屬性能讀不能改(像寵物的註冊編號),可以只寫 get,set 不寫或設成 private。這種屬性只能在建構子或宣告時設定值:


public class Dog
{
    public string RegistrationCode { get; }

    public Dog()
    {
        RegistrationCode = "DOG-001"; // 在建構子裡設定值
    }
}

現在外部只能讀 RegistrationCode,不能改。這樣可以保護重要資料不被亂改。

另一種寫法:private set


public string Name { get; private set; }
private setter——只能在 class 內部改

這樣屬性只能在 class 裡改(像在方法或建構子裡)。

唯寫:不太建議

理論上你可以做 set-only 屬性(只能寫不能讀),但這超少見也不建議——想像一個物件像「黑洞」:你可以丟東西進去,但永遠拿不回來。

4. init-only setter

一點歷史

以前如果你想做不可變物件(immutable),只能寫 get-only 屬性,然後在建構子裡設定值。OK,這樣也行——但有時不夠方便。最近 C# 出現了新語法:init-only 屬性。

init setter 到底是啥?

  • 只能在建立物件時設定屬性值(也就是在建構子或物件初始化器裡)。
  • 物件建立後,屬性就變成唯讀。
  • 超適合「幾乎不可變」的 class、DTO、設定、model。

public class Dog
{
    public string Name { get; init; }
    public int Age { get; init; }
}
init setter 屬性

現在你可以這樣寫:

Dog dog = new Dog { Name = "Бобик", Age = 2 };
dog.Name = "Рэкс"; // 錯誤! 建立後只能讀

也可以在建構子裡設定值:

public Dog(string name, int age)
{
    Name = name;
    Age = age;
}

圖表:什麼時候可以設定值

哪裡可以設定? { get; set; } { get; private set; } { get; init; }
class 外部、建立後 ✅ ❌ ❌
建構子裡 ✅ ✅ ✅
初始化器 ✅ ❌ ✅
class 內部 ✅ ✅ ❌(除了建構子)

5. 實戰應用

我們來重寫一下 Dog class,用自動屬性跟 init-only 屬性:


public class Dog
{
    // 只能初始化時設定的屬性
    public string Name { get; init; }
    public int Age { get; init; }

    // 自動屬性,表示目前狀態
    public bool IsHungry { get; set; }

    // 方法,狗狗的動作
    public void Bark()
    {
        Console.WriteLine($"{Name} 說:汪!");
    }
}

現在你可以這樣建立 Dog:

Dog dog = new Dog { Name = "Шарик", Age = 3, IsHungry = true };

dog.Bark(); // 會印出:Шарик 說:汪!
dog.IsHungry = false; // 這個屬性可以在建立後改
dog.Name = "Барбос"; // 錯誤!這個屬性只能初始化時設定

6. 自動屬性預設值

C# 很貼心,屬性可以直接給預設值:


public class Dog
{
    public string Name { get; set; } = "無名";
    public int Age { get; set; } = 0;
}
自動屬性預設值

也可以配 init 用:


public class Dog
{
    public string Name { get; init; } = "小狗";
    public int Age { get; init; } = 0;
}
init-only 屬性預設值

如果你建立時沒指定 Name,它就會是「小狗」。

7. 自動屬性不同存取權限

你可以讓屬性讀寫權限不一樣:


public class Dog
{
    public string Name { get; private set; }
    public int Age { get; private set; }
    
    public Dog(string name, int age)
    {
        Name = name;
        Age = age;
    }
}

這樣只有 Dog class 裡可以改名字跟年齡(像在方法或建構子裡)。

手動屬性 vs 自動屬性

方式 寫法難度 set/get 控制 建立後可改性 用在 model
手動屬性 很長 完全控制 隨便你 需要邏輯時
自動屬性 超短 沒控制 隨便你或 private 幾乎都能用
init-only 自動屬性 超短 沒控制 只能建立時改 DTO、設定檔

8. 用屬性常見錯誤

錯誤 #1: 想在建構子外改 get-only 屬性。
如果屬性只有 get,編譯器不會讓你在別的地方改。只能在建構子或宣告時設定。忘了就會編譯錯誤。

錯誤 #2: 欄位跟屬性搞混。
如果你把欄位換成自動屬性,要確定其他地方沒直接用欄位。欄位跟屬性是不同東西,如果還有舊的用法,編譯器可能報錯,或程式行為怪怪的。

錯誤 #3: private set 但沒搞清楚後果。
如果屬性有 private set,但其他地方還想改它——會錯。這常常是複製別人程式碼時不小心發生的。一定要確認 set 在你要用的地方能不能用。

2
任務
C# SELF, 等級 17, 課堂 2
上鎖
使用 init-only 屬性
使用 init-only 屬性
2
任務
C# SELF, 等級 17, 課堂 2
上鎖
自動屬性與初始值
自動屬性與初始值
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION