Partilhar via

A palavra-chave this

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

Observação

Este artigo discute a utilização de this para se referir à instância receptora no membro atual. Para obter mais informações sobre seu uso em métodos de extensão, consulte a extension palavra-chave.

A referência da linguagem C# documenta a versão mais recentemente lançada da linguagem C#. Contém também documentação inicial para funcionalidades em versões preliminares públicas para a próxima versão da linguagem.

A documentação identifica qualquer funcionalidade introduzida pela primeira vez nas últimas três versões da língua ou em pré-visualizações públicas atuais.

Sugestão

Para saber quando uma funcionalidade foi introduzida pela primeira vez em C#, consulte o artigo sobre o histórico de versões da linguagem C#.

Usos comuns de this incluem:

  • Membros qualificados ocultos por nomes semelhantes, tais como:

    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;
    }
}

  • Passar um objeto como parâmetro para outros métodos.

    CalcTax(this);

  • Indexadores declarados, tais como:

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

As funções membros estáticas existem ao nível da classe e não como parte de um objeto. Eles não têm ponteiro this . Referir-se a this num método estático é um erro.

No exemplo seguinte, os parâmetros name e alias ocultam campos com os mesmos nomes. A this palavra-chave qualifica essas variáveis como Employee membros da classe. A this palavra-chave também especifica o objeto para o método CalcTax, que pertence a outra classe.

class Employee
{
    private string name;
    private string alias;

    // 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: {name}
        Alias: {alias}
        """);
        // Passing the object to the CalcTax method by using this:
        Console.WriteLine($"Taxes: {Tax.CalcTax(this):C}");
    }

    public decimal Salary { get; } = 3000.00m;
}

class Tax
{
    public static decimal CalcTax(Employee E)=> 0.08m * E.Salary;
}

class Program
{
    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#.

Ver também

  • Last updated on