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

Ключевое слово 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#. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.

См. также

Ссылки

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

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

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

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

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

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

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