set (C#-Referenz)
Das Schlüsselwort set
definiert eine Accessor-Methode in einer Eigenschaft oder einem Indexer, die der Eigenschaft oder dem Indexer-Element einen Wert zuweist. Weitere Informationen und Beispiele finden Sie unter "Eigenschaften", "Automatisch implementierte Eigenschaften" und "Indexer".
Im folgenden Beispiel werden ein get
- und ein set
-Accessor für eine Eigenschaft namens Seconds
definiert. Im Beispiel wird ein privates Feld mit dem Namen _seconds
verwendet, um den Eigenschaftswert zu unterstützen.
class TimePeriod
{
private double _seconds;
public double Seconds
{
get { return _seconds; }
set
{
if (value < 0)
{
throw new ArgumentOutOfRangeException(nameof(value), "The value of the time period must be non-negative.");
}
_seconds = value;
}
}
}
Der set
-Accessor besteht häufig aus einer einzelnen Anweisung, die einen Wert zurückgibt (wie im vorherigen Beispiel gezeigt). Sie können die set
-Zugriffsmethode als Ausdruckskörpermember implementieren. Im folgenden Beispiel wird sowohl der get
- als auch der set
-Accessor als Ausdruckskörpermember implementiert.
class TimePeriod2
{
private double _seconds;
public double Seconds
{
get => _seconds;
set => _seconds = value;
}
}
Für einfache Fälle, in denen die Accessoren und set
Eigenschaften einer Eigenschaft get
keinen anderen Vorgang ausführen als das Festlegen oder Abrufen eines Werts in einem privaten Sicherungsfeld, können Sie die Unterstützung des C#-Compilers für automatisch implementierte Eigenschaften nutzen. Im folgenden Beispiel wird eine automatisch implementierte Hours
Eigenschaft implementiert.
class TimePeriod3
{
public double Hours { get; set; }
}
Wichtig
Automatisch implementierte Eigenschaften sind für Schnittstelleneigenschaftsdeklarationen oder die Implementierungsdeklaration für eine partielle Eigenschaft nicht zulässig. Der Compiler interpretiert die Syntax, die einer automatisch implementierten Eigenschaft entspricht, als deklarierende Deklaration, nicht als implementierende Deklaration.
C#-Sprachspezifikation
Weitere Informationen erhalten Sie unter C#-Sprachspezifikation. Die Sprachspezifikation ist die verbindliche Quelle für die Syntax und Verwendung von C#.