this (Referência C#)

A this palavra-chave refere-se à instância atual da classe e também é usada como um modificador do primeiro parâmetro de um método de extensão.

Nota

Este artigo discute o uso de com instâncias de this classe. Para obter mais informações sobre seu uso em métodos de extensão, consulte Métodos de extensão.

Os seguintes são usos comuns de this:

  • Para qualificar membros ocultos por nomes semelhantes, por exemplo:

    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;
        }
    }
    
  • Para passar um objeto como parâmetro para outros métodos, por exemplo:

    CalcTax(this);
    
  • Para declarar indexadores, por exemplo:

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

As funções de membro estático, porque existem no nível da classe e não como parte de um objeto, não têm um this ponteiro. É um erro para this se referir em um método estático.

Exemplo

Neste exemplo, this é usado para qualificar os membros name da Employee classe e alias, que estão ocultos por nomes semelhantes. Ele também é usado para passar um objeto para o método CalcTax, que pertence a outra classe.

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
 */

Especificação da linguagem C#

Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso do C#.

Consulte também