this (Referencia de C#)

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

[!NOTA]

En este artículo se analiza 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 (Guía de programación de C#).

A continuación, se indican algunos usos comunes de this:

  • Calificar miembros con el fin de evitar ambigüedades con nombres similares, por ejemplo:
public Employee(string name, string alias)
{
    // Use this to qualify the fields, name and alias:
    this.name = name;
    this.alias = alias;
}
  • Pasar un objeto como parámetro a otros métodos, por ejemplo, para:

    CalcTax(this);
    
  • Declarar indizadores, por ejemplo:

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

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

Ejemplo

En este ejemplo, this se utiliza para calificar los miembros de la clase Employee, name y alias, que presentan ambigüedad con nombres similares.También se utiliza para pasar un objeto al método CalcTax, el cual 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, vea 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

Referencia

Palabras clave de C#

base (Referencia de C#)

Métodos (Guía de programación de C#)

Conceptos

Guía de programación de C#

Otros recursos

Referencia de C#