From ea79df232bacbec320b77d55c13b63ea40852c68 Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Wed, 11 Mar 2026 12:34:08 +0800
Subject: [PATCH] =?UTF-8?q?refactor(GFramework.Core):=20=E4=BC=98=E5=8C=96?=
 =?UTF-8?q?ScopedArray=E5=AE=9E=E7=8E=B0=E5=B9=B6=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=E8=B5=84=E6=BA=90=E6=B8=85=E7=90=86=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为ScopedArray<T>实现IDisposable接口以支持资源清理
- 修改Array属性访问方式，通过GetArray方法确保对象未被释放
- 更新Length属性实现，依赖Array属性而非直接访问私有字段
- 调整AsSpan方法实现，统一通过Array属性获取数组实例
- 重写索引器实现，使用Array属性替代直接字段访问
- 新增GetArray私有方法，用于检查对象状态并返回内部数组
- 添加ObjectDisposedException异常处理，防止访问已释放对象
---
 .../Extensions/ArrayPoolExtensions.cs         | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/GFramework.Core/Extensions/ArrayPoolExtensions.cs b/GFramework.Core/Extensions/ArrayPoolExtensions.cs
index 64d6fd5..80a070a 100644
--- a/GFramework.Core/Extensions/ArrayPoolExtensions.cs
+++ b/GFramework.Core/Extensions/ArrayPoolExtensions.cs
@@ -89,7 +89,7 @@ public static class ArrayPoolExtensions
     ///     可自动释放的数组包装器
     /// </summary>
     /// <typeparam name="T">数组元素类型</typeparam>
-    public ref struct ScopedArray<T>
+    public ref struct ScopedArray<T> : IDisposable
     {
         private readonly ArrayPool<T> _pool;
         private readonly bool _clearOnReturn;
@@ -99,13 +99,13 @@ public static class ArrayPoolExtensions
         /// <summary>
         ///     获取租用的数组
         /// </summary>
-        public T[] Array => _array!;
+        public T[] Array => GetArray();
 #pragma warning restore CA1819
 
         /// <summary>
         ///     获取数组的长度
         /// </summary>
-        public int Length => _array!.Length;
+        public int Length => Array.Length;
 
         internal ScopedArray(ArrayPool<T> pool, int minimumLength, bool clearOnReturn)
         {
@@ -130,7 +130,7 @@ public static class ArrayPoolExtensions
         ///     获取数组的 Span 视图
         /// </summary>
         /// <returns>数组的 Span</returns>
-        public Span<T> AsSpan() => _array!;
+        public Span<T> AsSpan() => Array.AsSpan();
 
         /// <summary>
         ///     获取数组指定范围的 Span 视图
@@ -139,13 +139,23 @@ public static class ArrayPoolExtensions
         /// <param name="length">长度</param>
         /// <returns>数组指定范围的 Span</returns>
         public Span<T> AsSpan(int start, int length)
-            => _array!.AsSpan(start, length);
+            => Array.AsSpan(start, length);
 
         /// <summary>
         ///     获取数组指定索引处的引用
         /// </summary>
         /// <param name="index">要获取引用的索引位置</param>
         /// <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>));
+        }
     }
 }
\ No newline at end of file