Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

System.Func<T> in Action<T>: ustvarjanje in ponastavitev v zbirki objektov

Uporabi `Func<T>` kot tovarno brez parametrov in `Action<T>` za ponastavitev objekta, vrnjenega v lastno zbirko.

Različica: C# 12 and .NET 8; later runtimes may add compatible features

Sintaksa

// System delegate declarations (.NET 8)
public delegate TResult Func<out TResult>();
public delegate void Action<in T>(T obj);

// In a custom ObjectPool<T> where T : class, with using System;
// Constructor signature: public ObjectPool(Func<T> factory, Action<T> reset)
T item = factory();
reset(item);

V C# 12 in .NET 8 sta oba delegatska tipa v imenskem prostoru System. Pri Func<T> je T tip rezultata: factory() ne sprejme nobenega argumenta in vrne T. Pri Action<T> je T tip parametra: reset(item) sprejme en argument po vrednosti in vrne void. Pri razredu se kopira referenca, zato lahko ponastavitev spremeni stanje istega objekta.

Ne zamenjuj ju s Func<T, TResult> (en vhod in rezultat) ali z negeneričnim Action (brez vhoda in rezultata). Konstruktorju posreduj združljivo poimenovano metodo ali izraz lambda za poznejši klic. Pri referenčnih tipih out omogoča prireditev Func<Derived> v Func<Base>, in pa prireditev Action<Base> v Action<Derived>. Ti oznaki izražata varianco, ne podajanja argumentov po referenci.

V lastnem ObjectPool<T> iz primera Rent() pokliče tovarno samo, ko ni na voljo nobenega objekta. Return(item) ponastavi objekt pred morebitno shranitvijo, tudi če je edino mesto že zasedeno. Action<T> ne vrne odločitve o sprejemu objekta. Če ponastavitev sproži izjemo, se ta prenese do klicatelja in ta klic objekta ne shrani.

Ko objekt vrneš, ga ne uporabljaj več in ga ne vrni še enkrat. Primer ni varen za sočasno uporabo iz več niti in ne upravlja sproščanja virov z Dispose. To je lasten tip, ne Microsoft.Extensions.ObjectPool.ObjectPool<T>; ta knjižnica ponuja PooledObjectPolicy<T> za prilagoditev ustvarjanja in obravnave vrnjenih objektov.

Primeri

using System;
using System.Collections.Generic;

var pool = new ObjectPool<List<string>>(
    static () => new List<string>(),
    static list => list.Clear());

var first = pool.Rent();
first.Add("temporary");
pool.Return(first);

var second = pool.Rent();
Console.WriteLine($"Same instance: {object.ReferenceEquals(first, second)}");
Console.WriteLine($"Item count: {second.Count}");
pool.Return(second);

sealed class ObjectPool<T> where T : class
{
    private readonly Func<T> _factory;
    private readonly Action<T> _reset;
    private T? _available;

    public ObjectPool(Func<T> factory, Action<T> reset)
    {
        _factory = factory ?? throw new ArgumentNullException(nameof(factory));
        _reset = reset ?? throw new ArgumentNullException(nameof(reset));
    }

    public T Rent()
    {
        if (_available is T item)
        {
            _available = null;
            return item;
        }

        return _factory() ?? throw new InvalidOperationException("The factory returned null.");
    }

    public void Return(T item)
    {
        ArgumentNullException.ThrowIfNull(item);
        _reset(item);
        _available ??= item;
    }
}

Rezultat

Same instance: True
Item count: 0

Tovarna ob prvi izposoji ustvari seznam. Ob vrnitvi `Clear()` odstrani njegov element. Druga izposoja vrne isti, zdaj prazen seznam.

Povezane lekcije

  • C# · Lekcija 13 · Napredna · Različica: 3

Viri