CAMERA V1

FATrace.Com/ConfigHelper.cs

@@ -0,0 +1,214 @@
+using System;
+using System.Collections.Generic;
+using System.Configuration;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace FATrace.Com
+{
+    public class ConfigHelper
+    {
+        private static readonly Configuration AppConfiguration = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
+
+        /// <summary>
+        /// 根据 key 读取字符串配置。若不存在或为空，抛出带有明确提示的信息。
+        /// </summary>
+        public static string GetRequiredString(string configKey)
+        {
+            if (string.IsNullOrWhiteSpace(configKey))
+            {
+                throw new ArgumentException("配置键不能为空", nameof(configKey));
+            }
+
+            try
+            {
+                var raw = ConfigurationManager.AppSettings[configKey];
+                if (raw == null)
+                {
+                    throw new ConfigurationErrorsException($"未找到配置项: {configKey}");
+                }
+                var value = raw.Trim();
+                if (value.Length == 0)
+                {
+                    throw new ConfigurationErrorsException($"配置项为空: {configKey}");
+                }
+                return value;
+            }
+            catch (ConfigurationErrorsException)
+            {
+                throw;
+            }
+            catch (Exception ex)
+            {
+                throw new ConfigurationErrorsException($"读取配置项失败: {configKey}", ex);
+            }
+        }
+
+        /// <summary>
+        /// 根据 key 读取字符串配置，不存在时返回默认值。
+        /// </summary>
+        public static string GetStringOrDefault(string configKey, string defaultValue)
+        {
+            if (string.IsNullOrWhiteSpace(configKey)) return defaultValue;
+            try
+            {
+                var raw = ConfigurationManager.AppSettings[configKey];
+                return string.IsNullOrWhiteSpace(raw) ? defaultValue : raw.Trim();
+            }
+            catch
+            {
+                return defaultValue;
+            }
+        }
+
+        /// <summary>
+        /// 尝试读取字符串配置。
+        /// </summary>
+        public static bool TryGetString(string configKey, out string value)
+        {
+            value = string.Empty;
+            if (string.IsNullOrWhiteSpace(configKey)) return false;
+            try
+            {
+                var raw = ConfigurationManager.AppSettings[configKey];
+                if (raw == null) return false;
+                value = raw.Trim();
+                return true;
+            }
+            catch
+            {
+                return false;
+            }
+        }
+
+        /// <summary>
+        /// 读取 int 配置，支持默认值。
+        /// </summary>
+        public static int GetIntOrDefault(string configKey, int defaultValue)
+        {
+            var raw = GetStringOrDefault(configKey, string.Empty);
+            if (string.IsNullOrWhiteSpace(raw)) return defaultValue;
+            return int.TryParse(raw, out var result) ? result : defaultValue;
+        }
+
+        /// <summary>
+        /// 读取 bool 配置，支持默认值。
+        /// </summary>
+        public static bool GetBoolOrDefault(string configKey, bool defaultValue)
+        {
+            var raw = GetStringOrDefault(configKey, string.Empty);
+            if (string.IsNullOrWhiteSpace(raw)) return defaultValue;
+            return bool.TryParse(raw, out var result) ? result : defaultValue;
+        }
+
+        /// <summary>
+        /// 读取 TimeSpan 配置（毫秒或标准格式），支持默认值。
+        /// </summary>
+        public static TimeSpan GetTimeSpanOrDefault(string configKey, TimeSpan defaultValue)
+        {
+            var raw = GetStringOrDefault(configKey, string.Empty);
+            if (string.IsNullOrWhiteSpace(raw)) return defaultValue;
+
+            // 优先解析为毫秒整数
+            if (int.TryParse(raw, out var milliseconds))
+            {
+                return TimeSpan.FromMilliseconds(milliseconds);
+            }
+
+            return TimeSpan.TryParse(raw, out var ts) ? ts : defaultValue;
+        }
+
+        /// <summary>
+        /// 根据Key修改Value（保存到 App.config）。
+        /// </summary>
+        public static void SetValue(string configKey, string newValue)
+        {
+            if (string.IsNullOrWhiteSpace(configKey))
+            {
+                throw new ArgumentException("配置键不能为空", nameof(configKey));
+            }
+
+            try
+            {
+                if (AppConfiguration.AppSettings.Settings[configKey] == null)
+                {
+                    AppConfiguration.AppSettings.Settings.Add(configKey, newValue ?? string.Empty);
+                }
+                else
+                {
+                    AppConfiguration.AppSettings.Settings[configKey].Value = newValue ?? string.Empty;
+                }
+
+                AppConfiguration.Save();
+                ConfigurationManager.RefreshSection("appSettings");
+            }
+            catch (ConfigurationErrorsException)
+            {
+                throw;
+            }
+            catch (Exception ex)
+            {
+                throw new ConfigurationErrorsException($"写入配置项失败: {configKey}", ex);
+            }
+        }
+
+        /// <summary>
+        /// 添加新的 Key/Value。
+        /// </summary>
+        public static void Add(string configKey, string value)
+        {
+            if (string.IsNullOrWhiteSpace(configKey))
+            {
+                throw new ArgumentException("配置键不能为空", nameof(configKey));
+            }
+
+            try
+            {
+                AppConfiguration.AppSettings.Settings.Add(configKey, value ?? string.Empty);
+                AppConfiguration.Save();
+                ConfigurationManager.RefreshSection("appSettings");
+            }
+            catch (ConfigurationErrorsException)
+            {
+                throw;
+            }
+            catch (Exception ex)
+            {
+                throw new ConfigurationErrorsException($"添加配置项失败: {configKey}", ex);
+            }
+        }
+
+        /// <summary>
+        /// 根据 Key 删除项。
+        /// </summary>
+        public static void Remove(string configKey)
+        {
+            if (string.IsNullOrWhiteSpace(configKey)) return;
+            try
+            {
+                AppConfiguration.AppSettings.Settings.Remove(configKey);
+                AppConfiguration.Save();
+                ConfigurationManager.RefreshSection("appSettings");
+            }
+            catch (Exception ex)
+            {
+                throw new ConfigurationErrorsException($"删除配置项失败: {configKey}", ex);
+            }
+        }
+
+        /// <summary>
+        /// 读取必需的连接字符串配置。
+        /// </summary>
+        public static string GetRequiredConnectionString(string configKey)
+        {
+            var cs = GetRequiredString(configKey);
+            if (cs.IndexOf("Initial Catalog", StringComparison.OrdinalIgnoreCase) < 0 &&
+                cs.IndexOf("Database", StringComparison.OrdinalIgnoreCase) < 0)
+            {
+                throw new ConfigurationErrorsException($"连接字符串看起来不完整: {configKey}");
+            }
+            return cs;
+        }
+    }
+}