Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

System.Func<T> y Action<T>: creación y reinicio en un pool de objetos

Usa `Func<T>` como fábrica sin parámetros y `Action<T>` para restablecer un objeto devuelto a tu propio pool.

Versión: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxis

// 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);

En C# 12 y .NET 8, ambos tipos de delegado pertenecen al espacio de nombres System. En Func<T>, T es el tipo del resultado: factory() no recibe argumentos y devuelve un T. En Action<T>, T es el tipo del parámetro: reset(item) recibe un argumento por valor y devuelve void. Para una clase se copia la referencia, así que el delegado puede modificar el mismo objeto.

No los confundas con Func<T, TResult> (una entrada y un resultado) ni con Action no genérico (sin entrada ni resultado). Pasa un método con nombre compatible o una lambda al constructor para invocarlo más tarde. Para tipos de referencia, out permite asignar Func<Derived> a Func<Base> e in permite asignar Action<Base> a Action<Derived>. Esas marcas expresan varianza, no paso de argumentos por referencia.

En el ObjectPool<T> personalizado del ejemplo, Rent() llama a la fábrica solo si no hay ningún objeto disponible. Return(item) restablece el objeto antes de guardarlo si hay sitio, incluso cuando la única plaza ya está ocupada. Action<T> no devuelve una decisión de aceptación. Si el restablecimiento lanza una excepción, esta se propaga al llamador y esa llamada no guarda el objeto.

Después de devolver un objeto, no lo uses ni lo devuelvas de nuevo. El ejemplo no es seguro para el uso desde varios hilos y no gestiona la liberación de recursos mediante Dispose. Es un tipo propio, no Microsoft.Extensions.ObjectPool.ObjectPool<T>; esa biblioteca ofrece PooledObjectPolicy<T> para personalizar la creación y el tratamiento de las devoluciones.

Ejemplos

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

Resultado

Same instance: True
Item count: 0

La fábrica crea una lista en el primer préstamo. Al devolverla, `Clear()` elimina su elemento. El segundo préstamo recupera la misma lista, ahora vacía.

Lecciones relacionadas

  • C# · Lección 13 · Avanzado · Versión: 3

Fuentes