将Feature/XP.Common和Feature/XP.Hardware分支合并至Develop/XP.forHardwareAndCommon，完善XPapp注册和相关硬件类库通用类库功能。

2026-04-16 17:31:13 +08:00
parent 6ec4c3ddaa
commit 2bd6e566c3
581 changed files with 74600 additions and 222 deletions
@@ -0,0 +1,56 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Hardware.RaySource.Abstractions
+{
+    /// <summary>
+    /// 射线源操作结果封装类 | X-Ray Source Operation Result Wrapper
+    /// 用于统一返回操作状态、错误信息和数据 | Unified return of operation status, error messages, and data
+    /// </summary>
+    public class XRayResult
+    {
+        /// <summary>
+        /// 操作是否成功 | Operation success status
+        /// </summary>
+        public bool Success { get; set; }
+
+        /// <summary>
+        /// 错误消息（成功时为null）| Error message (null when successful)
+        /// </summary>
+        public string ErrorMessage { get; set; }
+
+        /// <summary>
+        /// 操作返回的数据 | Operation return data
+        /// </summary>
+        public object Data { get; set; }
+
+        /// <summary>
+        /// 创建成功结果 | Create success result
+        /// </summary>
+        /// <param name="data">返回数据 | Return data</param>
+        /// <returns>成功结果对象 | Success result object</returns>
+        public static XRayResult Ok(object data = null) =>
+            new XRayResult { Success = true, Data = data };
+
+        /// <summary>
+        /// 创建错误结果 | Create error result
+        /// </summary>
+        /// <param name="message">错误消息 | Error message</param>
+        /// <returns>错误结果对象 | Error result object</returns>
+        public static XRayResult Error(string message) =>
+            new XRayResult { Success = false, ErrorMessage = message };
+
+        /// <summary>
+        /// 获取浮点数据（带类型安全）| Get float data (type-safe)
+        /// </summary>
+        public float GetFloat() => Data != null ? Convert.ToSingle(Data) : 0f;
+
+        /// <summary>
+        /// 获取整数数据（带类型安全）| Get integer data (type-safe)
+        /// </summary>
+        public int GetInt() => Data != null ? Convert.ToInt32(Data) : 0;
+    }
+}