this (C# 參考)

  • 發行項

this 關鍵字指的是類別的目前執行個體，也用作擴充方法第一個參數的修飾詞。

注意

本文討論如何搭配使用 this 與類別執行個體。 如需其在擴充方法中之用法的詳細資訊，請參閱擴充方法。

下列是 this 的常見用法：

  • 限定透過類似名稱所隱藏的成員，例如︰

    public class Employee
{
    private string alias;
    private string name;

    public Employee(string name, string alias)
    {
        // Use this to qualify the members of the class
        // instead of the constructor parameters.
        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# 語法及用法的限定來源。

另請參閱