Compartilhar via


Este (C# Reference)

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

ObservaçãoObservação

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

A seguir estão os usos comuns do this:

  • Para qualificar membros ocultados por nomes semelhantes, por exemplo:
public Employee(string name, string alias)
{
    // Use this to qualify the fields, name and alias:
    this.name = name;
    this.alias = alias;
}
  • Para passar um objeto como um 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; }
}

Funções de membro estático, porque eles existem no nível de classe e não como parte de um objeto, não tem um this ponteiro.É um erro para se referir a this em um método estático.

Exemplo

Neste exemplo, this é usado para qualificar o Employee , membros de classe name 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 Especificação de linguagem do C# A especificação da linguagem é a fonte definitiva para a sintaxe e o uso da linguagem C#.

Consulte também

Referência

Palavras-chave C#

Base (referência de C#)

Métodos (guia de programação do C#)

Conceitos

Guia de programação do C#

Outros recursos

Referência de C#