C# Dies (Wie es für Entwickler funktioniert)

Die Grundlagen dieses Schlüsselworts

In einer öffentlichen Klasse, wie Employee zum Beispiel, können Sie öffentliche Instanzvariablen wie id oder name haben. Wenn Sie diesen Instanzvariablen in einer Methode Werte zuweisen möchten, stoßen Sie möglicherweise auf ein häufiges Problem: Was ist, wenn die Methodenparameter denselben Namen wie die Instanzvariablen haben?

Hier ist eine Lösung: Verwenden Sie das this-Schlüsselwort in der C#-Dokumentation! Im folgenden Beispiel einer Methode innerhalb der öffentlichen Klasse Employee wird das this-Schlüsselwort verwendet, um zwischen den Instanzvariablen und den Methodenparametern, die denselben Namen haben, zu unterscheiden.

public class Employee
{
    private int id;
    private string name;

    public void Display(int id, string name)
    {
        // Use `this.id` to refer to the instance variable, 
        // and `id` for the method parameter.
        this.id = id;
        this.name = name;
    }
}

public class Employee
{
    private int id;
    private string name;

    public void Display(int id, string name)
    {
        // Use `this.id` to refer to the instance variable, 
        // and `id` for the method parameter.
        this.id = id;
        this.name = name;
    }
}

Public Class Employee
	Private id As Integer
	Private name As String

	Public Sub Display(ByVal id As Integer, ByVal name As String)
		' Use `this.id` to refer to the instance variable, 
		' and `id` for the method parameter.
		Me.id = id
		Me.name = name
	End Sub
End Class

In diesem Fall bezieht sich this.id auf die Instanzvariable und id ist der Methodenparameter.

this-Schlüsselwort in Konstruktorüberladung

Durch die Nutzung des this-Schlüsselworts wird die Konstruktorüberladung eine mächtige Technik innerhalb derselben Klasse. Wenn eine Klasse, wie die Student-Klasse, mehrere Konstruktoren mit unterschiedlichen Parametern hat, ermöglicht das this-Schlüsselwort einem Konstruktor, einen anderen aufzurufen, wodurch redundanter Code vermieden wird.

Betrachten Sie das folgende Beispiel, in dem this in einem Parameterkonstruktor verwendet wird:

public class Student
{
    private string name;
    private int id;

    public Student() : this("Default", 0)
    {
        // Default constructor delegates to the parameterized constructor
        // with "Default" as the name and 0 as the id.
    }

    public Student(string name, int id)
    {
        // Assign the parameters to the instance variables
        this.name = name;
        this.id = id;
    }
}

public class Student
{
    private string name;
    private int id;

    public Student() : this("Default", 0)
    {
        // Default constructor delegates to the parameterized constructor
        // with "Default" as the name and 0 as the id.
    }

    public Student(string name, int id)
    {
        // Assign the parameters to the instance variables
        this.name = name;
        this.id = id;
    }
}

Public Class Student
	Private name As String
	Private id As Integer

	Public Sub New()
		Me.New("Default", 0)
		' Default constructor delegates to the parameterized constructor
		' with "Default" as the name and 0 as the id.
	End Sub

	Public Sub New(ByVal name As String, ByVal id As Integer)
		' Assign the parameters to the instance variables
		Me.name = name
		Me.id = id
	End Sub
End Class

Im parameterlosen Konstruktor ruft this("Default", 0) den parametrisierten Konstruktor auf, wobei Default als Name und 0 als ID festgelegt sind.

Erforschen von this in Erweiterungsmethoden

Erweiterungsmethoden in C# bieten eine Möglichkeit, Methoden zu bestehenden Typen hinzuzufügen, ohne den ursprünglichen Typ zu ändern. Hier ist, wo das this-Schlüsselwort etwas Magisches bewirkt. Es wird in der Parameterliste der Erweiterungsmethode verwendet, um auf den zu erweiternden Typ zu verweisen.

Betrachten Sie das folgende Beispiel einer Erweiterungsmethode:

public static class StringExtensions
{
    // This extension method can be called on any string instance
    public static bool IsNullOrEmpty(this string str)
    {
        return string.IsNullOrEmpty(str);
    }
}

public static class StringExtensions
{
    // This extension method can be called on any string instance
    public static bool IsNullOrEmpty(this string str)
    {
        return string.IsNullOrEmpty(str);
    }
}

Public Module StringExtensions
	' This extension method can be called on any string instance
	<System.Runtime.CompilerServices.Extension> _
	Public Function IsNullOrEmpty(ByVal str As String) As Boolean
		Return String.IsNullOrEmpty(str)
	End Function
End Module

Hier teilt this string str C# mit, dass dies eine Erweiterungsmethode für den Typ String ist. Jetzt können Sie diese Methode auf jedem String-Objekt wie if(myString.IsNullOrEmpty()) verwenden.

this in Indexern

Das this-Schlüsselwort kann auch bei der Definition von Indexern verwendet werden. Ein Indexer ermöglicht es, Instanzen einer Klasse genauso wie Arrays zu indizieren. Dies hilft Ihnen, auf Daten innerhalb von Objekten mit indexähnlicher Notation zuzugreifen. In einem Indexer wird this gefolgt von einem Array-Index, der üblicherweise int index ist.

Hier ist ein einfaches Beispiel für einen Indexer:

public class Test
{
    private int[] array = new int[100];

    // Define an indexer for the class
    public int this[int index]
    {
        get { return array[index]; }
        set { array[index] = value; }
    }
}

public class Test
{
    private int[] array = new int[100];

    // Define an indexer for the class
    public int this[int index]
    {
        get { return array[index]; }
        set { array[index] = value; }
    }
}

Public Class Test
	Private array(99) As Integer

	' Define an indexer for the class
	Default Public Property Item(ByVal index As Integer) As Integer
		Get
			Return array(index)
		End Get
		Set(ByVal value As Integer)
			array(index) = value
		End Set
	End Property
End Class

In dieser Klasse Test definiert das this-Schlüsselwort einen Indexer, der verwendet werden kann, um Werte im array-Instanzfeld abzurufen oder festzulegen.

this und statische Mitglieder

Eine Sache, die man über this beachten sollte, ist, dass es nicht verwendet werden kann, um statische Mitglieder oder Methoden zu referenzieren. Dies liegt daran, dass this sich auf die aktuelle Instanz bezieht, und statische Mitglieder gehören zur Klasse selbst, nicht zu einer Instanz der Klasse.

public class Program
{
    public static void Main(string[] args)
    {
        // Can't use `this` here, because 'Main' is a static method.
    }
}

public class Program
{
    public static void Main(string[] args)
    {
        // Can't use `this` here, because 'Main' is a static method.
    }
}

Public Class Program
	Public Shared Sub Main(ByVal args() As String)
		' Can't use `this` here, because 'Main' is a static method.
	End Sub
End Class

Also, denken Sie daran, this ist für Instanzen, nicht für klassenbezogene oder statische Mitglieder!

this-Schlüsselwort und Eigenschaften

Genau wie bei Instanzvariablen und Methodenparametern kann das this-Schlüsselwort auch mit Eigenschaften verwendet werden. In C# ist eine Eigenschaft ein Mitglied, das einen flexiblen Mechanismus zum Lesen, Schreiben oder Berechnen des Werts eines privaten Felds bereitstellt. Eigenschaften können verwendet werden, als ob sie öffentliche Datenmitglieder wären, sind aber tatsächlich spezielle Methoden, sogenannte Accessoren.

Schauen wir uns ein einfaches Beispiel an, das this in einer Eigenschaft verwendet:

public class Employee
{
    private string name;

    public string Name
    {
        get { return this.name; }
        set { this.name = value; } // Use `this` to refer to the instance variable
    }
}

public class Employee
{
    private string name;

    public string Name
    {
        get { return this.name; }
        set { this.name = value; } // Use `this` to refer to the instance variable
    }
}

Public Class Employee
'INSTANT VB NOTE: The field name was renamed since Visual Basic does not allow fields to have the same name as other class members:
	Private name_Conflict As String

	Public Property Name() As String
		Get
			Return Me.name_Conflict
		End Get
		Set(ByVal value As String)
			Me.name_Conflict = value
		End Set ' Use `this` to refer to the instance variable
	End Property
End Class

In der obigen Klasse wird das this-Schlüsselwort verwendet, um auf den privaten String name in den get- und set-Zugriffsperren der Name-Eigenschaft zu verweisen.

Erforschen von this und Delegaten

Ein weiterer Ort, an dem this auftaucht, sind Delegaten. Ein Delegate in C# ist ähnlich wie ein Funktionszeiger in C oder C++. Es ist eine Referenztyp-Variable, die die Referenz auf eine Methode enthält. Delegiertenmethoden, genau wie Erweiterungsmethoden, können this verwenden, um auf die aktuelle Instanz zuzugreifen.

Hier ist ein Beispiel für einen Delegaten, der this verwendet:

public delegate void DisplayDelegate();

public class Student
{
    public int Id { get; set; }
    public string Name { get; set; }

    public void Display()
    {
        // `this.DisplayDetails` refers to the method instance of the current object.
        DisplayDelegate displayDelegate = new DisplayDelegate(this.DisplayDetails);
        displayDelegate();
    }

    private void DisplayDetails()
    {
        Console.WriteLine("ID: " + Id + ", Name: " + Name);
    }
}

public delegate void DisplayDelegate();

public class Student
{
    public int Id { get; set; }
    public string Name { get; set; }

    public void Display()
    {
        // `this.DisplayDetails` refers to the method instance of the current object.
        DisplayDelegate displayDelegate = new DisplayDelegate(this.DisplayDetails);
        displayDelegate();
    }

    private void DisplayDetails()
    {
        Console.WriteLine("ID: " + Id + ", Name: " + Name);
    }
}

Public Delegate Sub DisplayDelegate()

Public Class Student
	Public Property Id() As Integer
	Public Property Name() As String

	Public Sub Display()
		' `this.DisplayDetails` refers to the method instance of the current object.
		Dim displayDelegate As New DisplayDelegate(AddressOf Me.DisplayDetails)
		displayDelegate()
	End Sub

	Private Sub DisplayDetails()
		Console.WriteLine("ID: " & Id & ", Name: " & Name)
	End Sub
End Class

In der Schülerklasse erstellt this.DisplayDetails eine neue Instanz des Delegaten, die sich auf die DisplayDetails-Methode des aktuellen Objekts bezieht.

Implementierung des this-Schlüsselworts mit IronPDF

Lassen Sie uns ein Beispiel betrachten, in dem Sie das this-Schlüsselwort in Verbindung mit IronPDF, einer leistungsstarken .NET-Bibliothek zum Bearbeiten und Erstellen von PDF-Dateien mit HTML, verwenden könnten.

Betrachten Sie eine Klasse mit dem Namen PDFHandler, die die IronPDF-Bibliothek verwendet, um verschiedene Operationen auf PDF-Dateien durchzuführen:

using IronPdf;

public class PDFHandler
{
    private string path;

    public PDFHandler(string path)
    {
        this.path = path;
    }

    public void GeneratePDF(string content)
    {
        // Creating a renderer to convert HTML content to PDF
        var Renderer = new IronPdf.ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf(content);

        // Save the generated PDF to the path specified by the current instance
        PDF.SaveAs(this.path);
    }
}

using IronPdf;

public class PDFHandler
{
    private string path;

    public PDFHandler(string path)
    {
        this.path = path;
    }

    public void GeneratePDF(string content)
    {
        // Creating a renderer to convert HTML content to PDF
        var Renderer = new IronPdf.ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf(content);

        // Save the generated PDF to the path specified by the current instance
        PDF.SaveAs(this.path);
    }
}

Imports IronPdf

Public Class PDFHandler
	Private path As String

	Public Sub New(ByVal path As String)
		Me.path = path
	End Sub

	Public Sub GeneratePDF(ByVal content As String)
		' Creating a renderer to convert HTML content to PDF
		Dim Renderer = New IronPdf.ChromePdfRenderer()
		Dim PDF = Renderer.RenderHtmlAsPdf(content)

		' Save the generated PDF to the path specified by the current instance
		PDF.SaveAs(Me.path)
	End Sub
End Class

In dieser PDFHandler-Klasse wird das this-Schlüsselwort verwendet, um auf das path-Feld der aktuellen Instanz zu verweisen. Dieses Feld wird verwendet, um das erzeugte PDF unter dem angegebenen Pfad zu speichern.

Wenn wir eine neue Instanz von PDFHandler erstellen und die GeneratePDF-Methode aufrufen, ermöglicht uns das this-Schlüsselwort, die während der Objekterstellung festgelegte path zu nutzen:

class Program
{
    static void Main(string[] args)
    {
        // Initialize PDFHandler with a specified file path
        PDFHandler pdfHandler = new PDFHandler("C:\\ThisKeyword.pdf");
        pdfHandler.GeneratePDF("Hello World!");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Initialize PDFHandler with a specified file path
        PDFHandler pdfHandler = new PDFHandler("C:\\ThisKeyword.pdf");
        pdfHandler.GeneratePDF("Hello World!");
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Initialize PDFHandler with a specified file path
		Dim pdfHandler As New PDFHandler("C:\ThisKeyword.pdf")
		pdfHandler.GeneratePDF("Hello World!")
	End Sub
End Class

Hier macht this den Code lesbarer und verständlicher, besonders wenn es um Bibliotheken wie IronPDF geht.

Abschluss

Inzwischen sollten Sie ein gutes Verständnis für das this-Schlüsselwort in C# haben, einschließlich seiner weitreichenden Verwendung von einfachen Instanzvariablen bis hin zu komplexen Kontexten wie Konstruktoren, Erweiterungsmethoden, Eigenschaften, Delegaten, anonymen Methoden und sogar bei der Verwendung von beliebten Bibliotheken wie IronPDF.

Denken Sie daran, IronPDF bietet eine kostenlose Testversion von IronPDF an, sodass Sie alles, was Sie heute gelernt haben, testen können. Wenn Sie sich entscheiden, fortzufahren, beginnen Lizenzen bereits bei nur $liteLicense. IronPDF kann eine wertvolle Ergänzung zu Ihrem C#-Entwicklungstoolkit sein, um die Aufgabe der PDF-Dateiverarbeitung in Ihren Anwendungen zu vereinfachen.