this (Справочник по C#)

Обновлен: Ноябрь 2007

Ключевое слово this ссылается на текущий экземпляр класса, а также используется в качестве модификатора первого параметра метода расширения.

Примечание.
В этой статье рассматривается использование 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"

См. также

Основные понятия

Руководство по программированию в C#

Ссылки

Ключевые слова C#

base (Справочник по C#)

Методы (Руководство по программированию на C#)

Другие ресурсы

Справочник по C#