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.