Freigeben über


this (C#-Referenz)

Aktualisiert: November 2007

Das this-Schlüsselwort verweist auf die aktuelle Instanz der Klasse und wird auch als Modifizierer des ersten Parameters einer Erweiterungsmethode verwendet.

Hinweis:

In diesem Artikel wird die Verwendung von this mit Klasseninstanzen erläutert. Weitere Informationen über die Verwendung in Erweiterungsmethoden finden Sie unter Erweiterungsmethoden (C#-Programmierhandbuch).

Im Folgenden sind häufige Verwendungen von this aufgeführt:

  • Kennzeichnen von Membern, die durch ähnliche Namen ausgeblendet sind, z. B.:
public Employee(string name, string alias)
{
    // Use this to qualify the fields, name and alias:
    this.name = name;
    this.alias = alias;
}
  • Übergeben eines Objekts als Parameter an andere Methoden, z. B.:

    CalcTax(this);
    
  • Deklarieren von Indexern, z. B.:

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

Da statische Memberfunktionen auf der Klassenebene bestehen und nicht Teil eines Objekts sind, besitzen sie keinen this-Zeiger. Es ist nicht zulässig, in einer statischen Methode auf this zu verweisen.

Beispiel

In diesem Beispiel wird this zum Kennzeichnen der Employee-Klassenmember name und alias verwendet, die durch ähnliche Namen ausgeblendet sind. Es wird ebenfalls eingesetzt, um ein Objekt an die CalcTax-Methode, die einer anderen Klasse angehört, zu übergeben.

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

C#-Programmiersprachenspezifikation

Weitere Informationen finden Sie in den folgenden Abschnitten von C#-Programmiersprachenspezifikation:

  • 7.5.7 this-Zugriff

  • 10.3.8.4 this-Zugriff

Siehe auch

Konzepte

C#-Programmierhandbuch

Referenz

C#-Schlüsselwörter

base (C#-Referenz)

Methoden (C#-Programmierhandbuch)

Weitere Ressourcen

C#-Referenz