Det angivna nyckelordet (C#-referens)

Nyckelordet set definierar en accessor-metod i en egenskap eller indexerare som tilldelar ett värde till egenskapen eller indexerarelementet. Mer information och exempel finns i Egenskaper, Automatiskt implementerade egenskaper och Indexerare.

C#-språkreferensen dokumenterar den senaste versionen av C#-språket. Den innehåller även inledande dokumentation för funktioner i offentliga förhandsversioner för den kommande språkversionen.

Dokumentationen identifierar alla funktioner som först introducerades i de tre senaste versionerna av språket eller i aktuella offentliga förhandsversioner.

Tips/Råd

Information om när en funktion först introducerades i C# finns i artikeln om språkversionshistoriken för C#.

För enkla fall där en egenskaps get och set accessorer inte utför någon annan åtgärd än att ange eller hämta ett värde i ett privat bakgrundsfält använder du automatiskt implementerade egenskaper. Följande exempel implementeras Hours som en automatiskt implementerad egenskap.

class TimePeriod3
{
    public double Hours { get; set; }
}

Viktigt!

Du kan inte använda automatiskt implementerade egenskaper för gränssnittsegenskapsdeklarationer eller implementeringsdeklarationen för en partiell egenskap. Kompilatorn tolkar syntax som matchar en automatiskt implementerad egenskap som deklareringsdeklaration, inte en implementeringsdeklaration.

Du kan behöva implementera ett av accessor-organen. Nyckelordet field , som lades till i C# 14, deklarerar en fältstödd egenskap. Använd en fältstödd egenskap för att låta kompilatorn generera en accessor medan du skriver den andra för hand. Använd nyckelordet field för att komma åt det kompilatorsyntetiserade bakgrundsfältet:

class TimePeriod4
{
    public double Hours {
        get;
        set => field = (value >= 0)
            ? value
            : throw new ArgumentOutOfRangeException(nameof(value), "The value must not be negative");
    }
}

set Ofta består accessorn av en enda instruktion som tilldelar ett värde, som det gjorde i föregående exempel. Du kan implementera set accessorn som en uttrycksbaserad medlem. I följande exempel implementeras både get och accessorerna set som uttrycksbaserade medlemmar.

class TimePeriod2
{
    private double _seconds;

    public double Seconds
    {
        get => _seconds;
        set => _seconds = value;
    }
}

I följande exempel definieras både en get och en set accessor för en egenskap med namnet Seconds. Det använder ett privat fält med namnet _seconds för att stödja egenskapsvärdet.

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;
        }
    }
}

Språkspecifikation för C#

Mer information finns i C#-språkspecifikationen. Språkspecifikationen är den slutgiltiga källan för C#-syntax och -användning.

Se även

• Egenskaper