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, Propriétés implémentées automatiquement et 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é en C# 14, 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");
    }
}

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.

Voir aussi

• Mots clés C#
• Propriétés