this (C# 參考)

發行項
08/21/2008

更新：2007 年 11 月

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# 語言規格中的下列章節：

7.5.7 this 存取
10.3.8.4 this 存取

請參閱

共用方式為

this (C# 參考)

範例

C# 語言規格

請參閱

概念

參考

其他資源

其他資源