refactor(GFramework.Core): 优化ScopedArray实现并添加资源清理功能

- 为ScopedArray<T>实现IDisposable接口以支持资源清理
- 修改Array属性访问方式,通过GetArray方法确保对象未被释放
- 更新Length属性实现,依赖Array属性而非直接访问私有字段
- 调整AsSpan方法实现,统一通过Array属性获取数组实例
- 重写索引器实现,使用Array属性替代直接字段访问
- 新增GetArray私有方法,用于检查对象状态并返回内部数组
- 添加ObjectDisposedException异常处理,防止访问已释放对象
This commit is contained in:
GeWuYou 2026-03-11 12:34:08 +08:00
parent ffda10be86
commit ea79df232b

View File

@ -89,7 +89,7 @@ public static class ArrayPoolExtensions
/// 可自动释放的数组包装器 /// 可自动释放的数组包装器
/// </summary> /// </summary>
/// <typeparam name="T">数组元素类型</typeparam> /// <typeparam name="T">数组元素类型</typeparam>
public ref struct ScopedArray<T> public ref struct ScopedArray<T> : IDisposable
{ {
private readonly ArrayPool<T> _pool; private readonly ArrayPool<T> _pool;
private readonly bool _clearOnReturn; private readonly bool _clearOnReturn;
@ -99,13 +99,13 @@ public static class ArrayPoolExtensions
/// <summary> /// <summary>
/// 获取租用的数组 /// 获取租用的数组
/// </summary> /// </summary>
public T[] Array => _array!; public T[] Array => GetArray();
#pragma warning restore CA1819 #pragma warning restore CA1819
/// <summary> /// <summary>
/// 获取数组的长度 /// 获取数组的长度
/// </summary> /// </summary>
public int Length => _array!.Length; public int Length => Array.Length;
internal ScopedArray(ArrayPool<T> pool, int minimumLength, bool clearOnReturn) internal ScopedArray(ArrayPool<T> pool, int minimumLength, bool clearOnReturn)
{ {
@ -130,7 +130,7 @@ public static class ArrayPoolExtensions
/// 获取数组的 Span 视图 /// 获取数组的 Span 视图
/// </summary> /// </summary>
/// <returns>数组的 Span</returns> /// <returns>数组的 Span</returns>
public Span<T> AsSpan() => _array!; public Span<T> AsSpan() => Array.AsSpan();
/// <summary> /// <summary>
/// 获取数组指定范围的 Span 视图 /// 获取数组指定范围的 Span 视图
@ -139,13 +139,23 @@ public static class ArrayPoolExtensions
/// <param name="length">长度</param> /// <param name="length">长度</param>
/// <returns>数组指定范围的 Span</returns> /// <returns>数组指定范围的 Span</returns>
public Span<T> AsSpan(int start, int length) public Span<T> AsSpan(int start, int length)
=> _array!.AsSpan(start, length); => Array.AsSpan(start, length);
/// <summary> /// <summary>
/// 获取数组指定索引处的引用 /// 获取数组指定索引处的引用
/// </summary> /// </summary>
/// <param name="index">要获取引用的索引位置</param> /// <param name="index">要获取引用的索引位置</param>
/// <returns>指定索引处元素的引用</returns> /// <returns>指定索引处元素的引用</returns>
public ref T this[int index] => ref _array![index]; public ref T this[int index] => ref Array[index];
/// <summary>
/// 获取内部数组实例
/// </summary>
/// <returns>内部数组实例</returns>
/// <exception cref="ObjectDisposedException">当对象已被丢弃时抛出</exception>
private T[] GetArray()
{
return _array ?? throw new ObjectDisposedException(nameof(ScopedArray<T>));
}
} }
} }