this (Referencia de C#)

  • Artículo

La palabra clave this hace referencia a la instancia actual de la clase y también se usa como modificador del primer parámetro de un método de extensión.

Nota:

En este artículo se describe el uso de this con instancias de clase. Para obtener más información sobre su uso en métodos de extensión, vea Métodos de extensión.

A continuación se indican usos habituales de this:

  • Para calificar a miembros ocultos por nombres similares, por ejemplo:

    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 pasar un objeto como parámetro a otros métodos, por ejemplo:

    CalcTax(this);

  • Para declarar indexadores, por ejemplo:

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

Las funciones miembro estáticas no tienen un puntero this, debido a que existen en el nivel de clase y no como parte de un objeto. Es un error hacer referencia a this en un método estático.

Ejemplo

En este ejemplo, se usa this para calificar los miembros de la clase Employee, name y alias, que están ocultos por nombres similares. También se usa para pasar un objeto al método CalcTax, que pertenece a otra clase.

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

Especificación del lenguaje C#

Para obtener más información, consulte la Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.

Vea también