this (Referencia de C#)
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#.