Ausdruckskörpermember (C#-Programmierhandbuch)
Mit Ausdruckskörperdefinitionen können Sie die Implementierung eines Members in einer präzisen und lesbaren Form darstellen. Sie können eine Ausdruckstextdefinition verwenden, wann immer die Logik für einen unterstützten Member, z.B. eine Methode oder Eigenschaft, aus einem einzelnen Ausdruck besteht. Eine Ausdruckstextdefinition hat die folgende allgemeine Syntax:
member => expression;
wobei expression ein gültiger Ausdruck ist.
Ausdruckstextdefinitionen können mit den folgenden Typmembern verwendet werden:
Methoden
Eine Ausdruckskörpermethode besteht aus einem einzelnen Ausdruck, der einen Wert zurückgibt, dessen Typ mit dem Rückgabetyp der Methode übereinstimmt bzw. für Methoden, die void zurückgeben, das einige Vorgänge ausführt. Beispielsweise enthalten Typen, die die ToString-Methode außer Kraft setzen normalerweise einen einzelnen Ausdruck, der die Zeichenfolgendarstellung des aktuellen Objekts zurückgibt.
Das folgende Beispiel definiert eine Person-Klasse, die die ToString-Methode mit einer Ausdruckstextmethode außer Kraft setzt. Es wird auch eine DisplayName-Methode definiert, die einen Namen für die Konsole anzeigt. Das Schlüsselwort return wird in der Ausdruckskörpermethode ToString nicht verwendet.
using System;
namespace ExpressionBodiedMembers;
public class Person
{
public Person(string firstName, string lastName)
{
fname = firstName;
lname = lastName;
}
private string fname;
private string lname;
public override string ToString() => $"{fname} {lname}".Trim();
public void DisplayName() => Console.WriteLine(ToString());
}
class Example
{
static void Main()
{
Person p = new Person("Mandy", "Dejesus");
Console.WriteLine(p);
p.DisplayName();
}
}
Weitere Informationen finden Sie unter Methoden (C#-Programmierhandbuch).
Schreibgeschützte Eigenschaften
Sie können eine Ausdruckstextdefinition verwenden, um eine schreibgeschützte Eigenschaft zu implementieren. Verwenden Sie hierzu die folgende Syntax:
PropertyType PropertyName => expression;
Im folgenden Beispiel wird eine Location-Klasse definiert, deren schreibgeschützte Eigenschaft Name als Ausdruckskörperdefinition implementiert wird, die den Wert des privaten locationName-Felds zurückgibt:
public class Location
{
private string locationName;
public Location(string name)
{
locationName = name;
}
public string Name => locationName;
}
Weitere Informationen zu Eigenschaften finden Sie unter Eigenschaften (C#-Programmierhandbuch).
Eigenschaften
Sie können Ausdruckstextdefinitionen zum Implementieren von get-Eigenschaften und set-Accessoren verwenden. Im folgenden Beispiel wird die dafür erforderliche Vorgehensweise veranschaulicht:
public class Location
{
private string locationName;
public Location(string name) => Name = name;
public string Name
{
get => locationName;
set => locationName = value;
}
}
Weitere Informationen zu Eigenschaften finden Sie unter Eigenschaften (C#-Programmierhandbuch).
Ereignisse
Ebenso können Ereignis add- und remove-Zugriffsmethoden Ausdruckskörper sein:
public class ChangedEventArgs : EventArgs
{
public required int NewValue { get; init; }
}
public class ObservableNum(int _value)
{
public event EventHandler<ChangedEventArgs> ChangedGeneric = default!;
public event EventHandler Changed
{
// Note that, while this is syntactically valid, it won't work as expected because it's creating a new delegate object with each call.
add => ChangedGeneric += (sender, args) => value(sender, args);
remove => ChangedGeneric -= (sender, args) => value(sender, args);
}
public int Value
{
get => _value;
set => ChangedGeneric?.Invoke(this, new() { NewValue = (_value = value) });
}
}
Weitere Informationen zu Ereignissen finden Sie unter Ereignisse (C# Programmierhandbuch).
Konstruktoren
Eine Ausdruckstextdefinition für einen Konstruktor enthält in der Regel einen einzelnen Zuweisungsausdruck oder einen Methodenaufruf, der die Argumente des Konstruktors behandelt oder den Instanzzustand initialisiert.
Im folgenden Beispiel wird eine Location-Klasse definiert, deren Klassenkonstruktor einen einzelnen Zeichenfolgenparameter namens name enthält. Die Ausdruckstextdefinition weist das Argument für die Eigenschaft Name zu.
public class Location
{
private string locationName;
public Location(string name) => Name = name;
public string Name
{
get => locationName;
set => locationName = value;
}
}
Weitere Informationen finden Sie unter Konstruktoren (C#-Programmierhandbuch).
Finalizer
Eine Ausdruckstextdefinition für einen Finalizer enthält normalerweise Bereinigungsanweisungen, z.B. Anweisungen, die nicht verwaltete Ressourcen veröffentlichen.
Im folgenden Beispiel wird ein Finalizer definiert, der eine Ausdruckstextdefinition verwendet, um anzugeben, dass der Finalizer aufgerufen wurde.
public class Destroyer
{
public override string ToString() => GetType().Name;
~Destroyer() => Console.WriteLine($"The {ToString()} finalizer is executing.");
}
Weitere Informationen finden Sie unter Finalizer (C#-Programmierhandbuch).
Indexer
Genauso wie Eigenschaften bestehen die get- und set-Accessoren des Indexers aus Ausdruckstextdefinitionen, wenn der get-Accessor aus einem einzelnen Ausdruck besteht, der einen Wert zurückgibt, oder der set-Accessor führt eine einfache Zuweisung aus.
Im folgenden Beispiel wird eine Klasse namens Sports definiert, die ein internes String-Array enthält, das aus den Namen einiger Sportarten besteht. Die get- und set-Accessoren des Indexers werden als Ausdruckstextdefinitionen implementiert.
using System;
using System.Collections.Generic;
namespace SportsExample;
public class Sports
{
private string[] types = [ "Baseball", "Basketball", "Football",
"Hockey", "Soccer", "Tennis",
"Volleyball" ];
public string this[int i]
{
get => types[i];
set => types[i] = value;
}
}
Weitere Informationen finden Sie unter Indexer (C#-Programmierhandbuch).
