this (C# 參考)

this 關鍵字所指的是類別 (Class) 的目前執行個體 (Instance),而且也用來當做擴充方法之第一個參數的修飾詞 (Modifier)。

注意事項注意事項

本文將會討論搭配類別執行個體來使用 this。 如需在擴充方法中使用此關鍵字的詳細資訊,請參閱擴充方法 (C# 程式設計手冊)

以下為 this 的常見用法:

  • 要限定被類似名稱所隱藏的成員,例如:
public Employee(string name, string alias)
{
    // Use this to qualify the fields, name and alias:
    this.name = name;
    this.alias = alias;
}
  • 要將物件做為參數傳遞到其他方法,例如:

    CalcTax(this);
    
  • 要宣告索引子,例如:

public int this[int param]
{
    get { return array[param]; }
    set { array[param] = value; }
}

因為靜態成員函式存在於類別層級,且非物件的一部分,所以不具有 this 指標。 在靜態方法中參考 this 是錯誤的。

範例

這個範例使用 this 限定被類似名稱隱藏的 Employee 類別成員,name 和 alias。 它也用來將物件傳遞給 CalcTax 這個屬於其他類別的方法。

        class Employee
        {
            private string name;
            private string alias;
            private decimal salary = 3000.00m;

            // Constructor:
            public Employee(string name, string alias)
            {
                // Use this to qualify the fields, name and alias:
                this.name = name;
                this.alias = alias;
            }
            // Printing method:
            public void printEmployee()
            {
                Console.WriteLine("Name: {0}\nAlias: {1}", name, alias);
                // Passing the object to the CalcTax method by using this:
                Console.WriteLine("Taxes: {0:C}", Tax.CalcTax(this));
            }

            public decimal Salary
            {
                get { return salary; }
            }
        }

        class Tax
        {
            public static decimal CalcTax(Employee E)
            {
                return 0.08m * E.Salary;
            }
        }

        class MainClass
        {
            static void Main()
            {
                // Create objects:
                Employee E1 = new Employee("Mingda Pan", "mpan");

                // Display results:
                E1.printEmployee();
            }
        }
        /*
        Output:
            Name: Mingda Pan
            Alias: mpan
            Taxes: $240.00
         */

C# 語言規格

如需詳細資訊,請參閱 C# 語言規格。 語言規格是 C# 語法和用法的決定性來源。

請參閱

參考

C# 關鍵字

base (C# 參考)

方法 (C# 程式設計手冊)

概念

C# 程式設計手冊

其他資源

C# 參考