feat(Foundation.Extensions): 添加目录扩展方法支持递归创建目录

Author: AlianBlank

GameFrameX.Foundation.Extensions/DirectoryExtensions.cs

@@ -0,0 +1,63 @@
+// ==========================================================================================
+//  GameFrameX 组织及其衍生项目的版权、商标、专利及其他相关权利
+//  GameFrameX organization and its derivative projects' copyrights, trademarks, patents, and related rights
+//  均受中华人民共和国及相关国际法律法规保护。
+//  are protected by the laws of the People's Republic of China and relevant international regulations.
+// 
+//  使用本项目须严格遵守相应法律法规及开源许可证之规定。
+//  Usage of this project must strictly comply with applicable laws, regulations, and open-source licenses.
+// 
+//  本项目采用 MIT 许可证与 Apache License 2.0 双许可证分发，
+//  This project is dual-licensed under the MIT License and Apache License 2.0,
+//  完整许可证文本请参见源代码根目录下的 LICENSE 文件。
+//  please refer to the LICENSE file in the root directory of the source code for the full license text.
+// 
+//  禁止利用本项目实施任何危害国家安全、破坏社会秩序、
+//  It is prohibited to use this project to engage in any activities that endanger national security, disrupt social order,
+//  侵犯他人合法权益等法律法规所禁止的行为！
+//  or infringe upon the legitimate rights and interests of others, as prohibited by laws and regulations!
+//  因基于本项目二次开发所产生的一切法律纠纷与责任，
+//  Any legal disputes and liabilities arising from secondary development based on this project
+//  本项目组织与贡献者概不承担。
+//  shall be borne solely by the developer; the project organization and contributors assume no responsibility.
+// 
+//  GitHub 仓库：https://github.com/GameFrameX
+//  GitHub Repository: https://github.com/GameFrameX
+//  Gitee  仓库：https://gitee.com/GameFrameX
+//  Gitee Repository:  https://gitee.com/GameFrameX
+//  官方文档：https://gameframex.doc.alianblank.com/
+//  Official Documentation: https://gameframex.doc.alianblank.com/
+// ==========================================================================================
+
+namespace GameFrameX.Foundation.Extensions;
+
+public static class DirectoryExtensions
+{
+    /// <summary>
+    /// 根据路径创建目录，支持递归创建。
+    /// </summary>
+    /// <param name="path">目录路径。</param>
+    /// <param name="isFile">是否为文件路径，如果为true，则创建文件所在的目录。默认为false。</param>
+    /// <exception cref="ArgumentNullException">当path为null时抛出。</exception>
+    /// <remarks>
+    /// 如果路径不存在，会递归创建所有必需的父目录
+    /// 当isFile为true时，会自动获取文件所在目录路径
+    /// 支持相对路径和绝对路径
+    /// 如果目录已存在，则不会进行任何操作
+    /// </remarks>
+    public static void CreateAsDirectory(this string path, bool isFile = false)
+    {
+        ArgumentNullException.ThrowIfNull(path, nameof(path));
+
+        if (isFile)
+        {
+            path = Path.GetDirectoryName(path);
+        }
+
+        if (!Directory.Exists(path))
+        {
+            CreateAsDirectory(path, true);
+            Directory.CreateDirectory(path);
+        }
+    }
+}