自動實作的屬性 (C# 程式設計手冊)

當屬性存取子中不需要其他邏輯時,自動實作的屬性會讓屬性宣告更簡潔。 它們還可讓用戶端程式碼建立物件。 當您宣告屬性時,如下列範例所示,編譯器會建立私用、匿名的支援欄位,但只能透過屬性的 getset 存取子才能存取。 在 C# 9 和更新版本中, init 存取子也可以宣告為自動實作的屬性。

範例

下列範例示範一個簡單的類別,其中包含一些自動實作的屬性:

// This class is mutable. Its data can be modified from
// outside the class.
public class Customer
{
    // Auto-implemented properties for trivial get and set
    public double TotalPurchases { get; set; }
    public string Name { get; set; }
    public int CustomerId { get; set; }

    // Constructor
    public Customer(double purchases, string name, int id)
    {
        TotalPurchases = purchases;
        Name = name;
        CustomerId = id;
    }

    // Methods
    public string GetContactInfo() { return "ContactInfo"; }
    public string GetTransactionHistory() { return "History"; }

    // .. Additional methods, events, etc.
}

class Program
{
    static void Main()
    {
        // Initialize a new object.
        Customer cust1 = new Customer(4987.63, "Northwind", 90108);

        // Modify a property.
        cust1.TotalPurchases += 499.99;
    }
}

您無法在介面中宣告自動實作的屬性。 自動實作的屬性會宣告私用實例備份欄位,而且介面可能不會宣告實例欄位。 在介面中宣告屬性,而不定義主體會宣告具有存取子的屬性,而該存取子必須由實作該介面的每個型別實作。

您可以初始化與欄位類似的自動實作屬性:

public string FirstName { get; set; } = "Jane";

先前範例中顯示的類別可變動。 用戶端程式代碼可以在建立之後變更 物件中的值。 在包含重要行為的複雜類別中, (方法) 和資料,通常需要具有公用屬性。 不過,對於只封裝一組值的小型類別或結構, (資料) ,而且只有少數或沒有任何行為,您應該使用下列其中一個選項讓物件不可變:

  • 除了建構函式) 以外,只 get 宣告存取子 (不可變。
  • get宣告存取子和 init 存取子 (物件) 建構期間以外的所有位置不可變。
  • set 存取子宣告為 用 (不可變給取用者) 。

如需詳細資訊,請參閱 如何使用自動實作的屬性來實作輕量型類別

另請參閱