RU CSharp Keyword scoped

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C#: scoped

Справочник C# · Практическое руководство

scoped ограничивает допустимое время жизни ссылку или ref-like значение параметра. Компилятор не позволит вернуть такую ​​ссылку способом, который выходит за установленную область жизни. Модификатор не делает данные постоянными: через scoped ref разрешено изменять значение вызова.

Простой пример (Example.cs)

Сохраните этот пример отдельно как Example.cs. Запускайте его независимо от остальных примеров страницы.

Example.cs:

// PROJECT-EXAMPLE
void Add(scoped ref int value) { value += 2; }
int count = 3;
Add(ref count);
System.Console.WriteLine(count);

Результат:

5

Синтаксис

static int Sum(scoped ReadOnlySpan<int> values);
static void Add(scoped ref int value, int amount);

Чтение данных из stackalloc в scoped-параметре

using System;

internal static class Program
{
    public static void Main()
    {
        ReadOnlySpan<int> readings = stackalloc int[] { 3, 5, 7 };
        Console.WriteLine(Sum(readings));
    }
    private static int Sum(scoped ReadOnlySpan<int> values)
    {
        int total = 0;
        foreach (int value in values) total += value;
        return total;
    }
}

Результат:

15

Изменение числа через scoped ref без возврата ссылки

using System;

internal static class Program
{
    public static void Main()
    {
        int points = 10;
        Add(ref points, 4);
        Add(ref points, 6);
        Console.WriteLine(points);
    }
    private static void Add(scoped ref int value, int amount)
    {
        value += amount;
    }
}

Результат:

20

Официальный источник: Microsoft Learn.