Le mot clé get
Le mot clé get définit une méthode Accessor dans une propriété ou un indexeur qui retourne la valeur de la propriété ou l’élément de l’indexeur. Pour plus d’informations, consultez Propriétés, implémentation automatique des propriétéset Indexeurs.
Pour les cas simples dans lesquels les accesseurs et get les propriétés n’effectuent set aucune autre opération que la définition ou la récupération d’une valeur dans un champ de stockage privé, vous pouvez tirer parti de la prise en charge du compilateur C# pour les propriétés implémentées automatiquement. L’exemple suivant implémente Hours en tant que propriété implémentée automatiquement.
class TimePeriod3
{
public double Hours { get; set; }
}
Important
Les propriétés implémentées automatiquement ne sont pas autorisées pour les déclarations de propriété d’interface ou la déclaration d’implémentation d’une propriété partielle. Le compilateur interprète la syntaxe correspondant à une propriété implémentée automatiquement comme la déclaration déclarante, et non comme une déclaration d’implémentation.
Souvent, l’accesseur get se compose d’une seule instruction qui retourne une valeur, comme dans l’exemple précédent. Vous pouvez implémenter l’accesseur get comme membre expression-bodied. L’exemple suivant implémente l’accesseur get et l’accesseur set en tant que membres expression-bodied.
class TimePeriod2
{
private double _seconds;
public double Seconds
{
get => _seconds;
set => _seconds = value;
}
}
Vous pouvez constater que vous devez implémenter l’un des corps d’accesseur. Vous pouvez utiliser une propriété de retour de champ pour permettre au compilateur de générer un accesseur lors de l’écriture de l’autre. Vous utilisez le field mot clé, ajouté comme fonctionnalité d’aperçu en C# 13, pour accéder au champ de stockage synthétisé du compilateur :
class TimePeriod4
{
public double Hours {
get;
set => field = (value >= 0)
? value
: throw new ArgumentOutOfRangeException(nameof(value), "The value must not be negative");
}
}
Important
Le field mot clé est une fonctionnalité d’aperçu en C# 13. Vous devez utiliser .NET 9 et définir votre <LangVersion> élément preview dans votre fichier projet afin d’utiliser le field mot clé contextuel.
Vous devez être prudent à l’aide de la field fonctionnalité de mot clé dans une classe qui a un champ nommé field. Le nouveau field mot clé ombre un champ nommé field dans l’étendue d’un accesseur de propriété. Vous pouvez modifier le nom de la field variable ou utiliser le @ jeton pour référencer l’identificateur field en tant que @field. Pour plus d’informations, lisez la spécification de fonctionnalité pour le field mot clé.
L’exemple suivant définit un accesseur get et un accesseur set pour une propriété nommée Seconds. Il utilise un champ privé nommé _seconds pour stocker la valeur de la propriété.
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;
}
}
}
Spécification du langage C#
Pour plus d'informations, voir la spécification du langage C#. La spécification du langage est la source de référence pour la syntaxe C# et son utilisation.
