/// <summary>
  /// 提供測試用例的注冊和運行功能，用來比對結果和預期值是否相同，向控制臺輸出結果。
  /// </summary>
  public class 測試用例 {
    /// <summary>
    /// 測試的方法
    /// </summary>
    public Func<string> 方法 { get; set; }
    /// <summary>
    /// 測試名稱
    /// </summary>
    public string 名稱 { get; set; }
    /// <summary>
    /// 期望得到的結果string
    /// </summary>
    public string 期望值 { get; set; }
    /// <summary>
    /// 新建一個測試
    /// </summary>
    /// <param name="v名稱">測試名稱</param>
    /// <param name="v期望值">期望得到的結果string</param>
    /// <param name="v方法">測試的方法</param>
    public 測試用例(string v名稱, string v期望值, Func<string> v方法) {
      名稱 = v名稱;
      期望值 = v期望值;
      方法 = v方法;
    }

    /// <summary>
    /// 儲存所有注冊的方法。
    /// </summary>
    public static OrderedDictionary<string, 測試用例> 方法冊 = new OrderedDictionary<string, 測試用例>();

    /// <summary>
    /// 將「返回值為string的方法〈Func<string>〉」注冊到「方法冊」中。
    /// </summary>
    /// <param name="測試用例">要注冊的測試</param>
    /// <returns>返回是否注冊成功</returns>
    public static bool 注冊(測試用例 測試用例) {
      return 方法冊.添加(測試用例.名稱, 測試用例);
    }

    /// <summary>
    /// 運行指定名稱的測試并返回運行結果〈<see cref="string"/>〉
    /// </summary>
    /// <param name="名稱">方法注冊到測試的名稱</param>
    /// <returns>返回運行結果〈<see cref="string"/>〉</returns>
    public static string 運行(string 名稱) {
      if (方法冊.有鍵(名稱)) {
        return 方法冊[名稱].方法.Invoke();
      } else {
        return 名稱 + "  : 不存在該方法!";
      }
    }
    /// <summary>
    /// 注冊并向控制臺輸出運行結果。
    /// </summary>
    /// <param name="測試用例"></param>
    public static void 注冊并Print(測試用例 測試用例) {
      if(方法冊.添加(測試用例.名稱, 測試用例)) {
        Print(測試用例.名稱);
      }
      
    }
    /// <summary>
    /// 向控制臺輸出運行結果。
    /// </summary>
    /// <param name="測試用例"></param>
    public static void Print(測試用例 測試用例) {
      Print(測試用例.名稱);
    }
    /// <summary>
    /// 向控制臺輸出運行結果。
    /// </summary>
    /// <param name="名稱"></param>
    public static void Print(string 名稱) {
      string 結果 = 運行(名稱);
      string 期望 = 方法冊[名稱].期望值;
      Console.WriteLine(名稱 + "\r\nResult: "+ 結果);
      Console.Write("期望值: " + 期望);
      if (結果 == 期望) {
        var c = Console.ForegroundColor;
        Console.ForegroundColor = ConsoleColor.Green;
        Console.WriteLine(" [TRUE]");
        Console.ForegroundColor = c;
      } else {
        var c = Console.ForegroundColor;
        Console.ForegroundColor = ConsoleColor.Red;
        Console.WriteLine(" [FALSE]");
        Console.ForegroundColor = c;
      }
    }

  }

//************************************************************
  /// <summary>
  /// ◇ 增強 枚舉〖System.Enun〗的擴展功能。
  /// </summary>
  /// <seealso cref="Enum"/>
  /// <remarks></remarks>
  //************************************************************
  public static class EnumEx {
    //=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    /// <summary>
    /// 返回枚舉 「thisEnum」 的定義名稱〈<see cref="string"/>〉
    /// </summary>
    /// <param name="thisEnum">該枚舉自身</param>
    /// <returns>〈string〉返回枚舉的定義名稱</returns>
    public static string Name(this Enum thisEnum) {
      return Enum.GetName(thisEnum.GetType(), thisEnum);
    }

/// <summary>
  /// EnumEx的測試用例。
  /// </summary>
  public class EnumEx {
    /// <summary>【測試用例】EnumEx.Name() </summary>
    public static 測試用例 Name = new 測試用例("EnumEx.Name - UriComponents.Path.Name()", "Path", NameFunc);
    /// <summary>【測試方法】UriComponents.Path調用EnumEx.Name() 返回值 ➤ "Path" </summary>
    /// <returns>返回值應該等于"Path"</returns>
    public static string NameFunc() { return UriComponents.Path.Name(); }
  }