IDataTable.cs 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. //------------------------------------------------------------
  2. // Game Framework
  3. // Copyright © 2013-2021 loyalsoft. All rights reserved.
  4. // Homepage: http://www.game7000.com/
  5. // Feedback: http://www.game7000.com/
  6. //------------------------------------------------------------
  7. using System;
  8. using System.Collections.Generic;
  9. namespace GameFramework.DataTable
  10. {
  11. /// <summary>
  12. /// 数据表接口。
  13. /// </summary>
  14. /// <typeparam name="T">数据表行的类型。</typeparam>
  15. public interface IDataTable<T> : IEnumerable<T> where T : IDataRow
  16. {
  17. /// <summary>
  18. /// 获取数据表名称。
  19. /// </summary>
  20. string Name
  21. {
  22. get;
  23. }
  24. /// <summary>
  25. /// 获取数据表完整名称。
  26. /// </summary>
  27. string FullName
  28. {
  29. get;
  30. }
  31. /// <summary>
  32. /// 获取数据表行的类型。
  33. /// </summary>
  34. Type Type
  35. {
  36. get;
  37. }
  38. /// <summary>
  39. /// 获取数据表行数。
  40. /// </summary>
  41. int Count
  42. {
  43. get;
  44. }
  45. /// <summary>
  46. /// 获取数据表行。
  47. /// </summary>
  48. /// <param name="id">数据表行的编号。</param>
  49. /// <returns>数据表行。</returns>
  50. T this[int id]
  51. {
  52. get;
  53. }
  54. /// <summary>
  55. /// 获取编号最小的数据表行。
  56. /// </summary>
  57. T MinIdDataRow
  58. {
  59. get;
  60. }
  61. /// <summary>
  62. /// 获取编号最大的数据表行。
  63. /// </summary>
  64. T MaxIdDataRow
  65. {
  66. get;
  67. }
  68. /// <summary>
  69. /// 检查是否存在数据表行。
  70. /// </summary>
  71. /// <param name="id">数据表行的编号。</param>
  72. /// <returns>是否存在数据表行。</returns>
  73. bool HasDataRow(int id);
  74. /// <summary>
  75. /// 检查是否存在数据表行。
  76. /// </summary>
  77. /// <param name="condition">要检查的条件。</param>
  78. /// <returns>是否存在数据表行。</returns>
  79. bool HasDataRow(Predicate<T> condition);
  80. /// <summary>
  81. /// 获取数据表行。
  82. /// </summary>
  83. /// <param name="id">数据表行的编号。</param>
  84. /// <returns>数据表行。</returns>
  85. T GetDataRow(int id);
  86. /// <summary>
  87. /// 获取符合条件的数据表行。
  88. /// </summary>
  89. /// <param name="condition">要检查的条件。</param>
  90. /// <returns>符合条件的数据表行。</returns>
  91. /// <remarks>当存在多个符合条件的数据表行时,仅返回第一个符合条件的数据表行。</remarks>
  92. T GetDataRow(Predicate<T> condition);
  93. /// <summary>
  94. /// 获取符合条件的数据表行。
  95. /// </summary>
  96. /// <param name="condition">要检查的条件。</param>
  97. /// <returns>符合条件的数据表行。</returns>
  98. T[] GetDataRows(Predicate<T> condition);
  99. /// <summary>
  100. /// 获取符合条件的数据表行。
  101. /// </summary>
  102. /// <param name="condition">要检查的条件。</param>
  103. /// <param name="results">符合条件的数据表行。</param>
  104. void GetDataRows(Predicate<T> condition, List<T> results);
  105. /// <summary>
  106. /// 获取排序后的数据表行。
  107. /// </summary>
  108. /// <param name="comparison">要排序的条件。</param>
  109. /// <returns>排序后的数据表行。</returns>
  110. T[] GetDataRows(Comparison<T> comparison);
  111. /// <summary>
  112. /// 获取排序后的数据表行。
  113. /// </summary>
  114. /// <param name="comparison">要排序的条件。</param>
  115. /// <param name="results">排序后的数据表行。</param>
  116. void GetDataRows(Comparison<T> comparison, List<T> results);
  117. /// <summary>
  118. /// 获取排序后的符合条件的数据表行。
  119. /// </summary>
  120. /// <param name="condition">要检查的条件。</param>
  121. /// <param name="comparison">要排序的条件。</param>
  122. /// <returns>排序后的符合条件的数据表行。</returns>
  123. T[] GetDataRows(Predicate<T> condition, Comparison<T> comparison);
  124. /// <summary>
  125. /// 获取排序后的符合条件的数据表行。
  126. /// </summary>
  127. /// <param name="condition">要检查的条件。</param>
  128. /// <param name="comparison">要排序的条件。</param>
  129. /// <param name="results">排序后的符合条件的数据表行。</param>
  130. void GetDataRows(Predicate<T> condition, Comparison<T> comparison, List<T> results);
  131. /// <summary>
  132. /// 获取所有数据表行。
  133. /// </summary>
  134. /// <returns>所有数据表行。</returns>
  135. T[] GetAllDataRows();
  136. /// <summary>
  137. /// 获取所有数据表行。
  138. /// </summary>
  139. /// <param name="results">所有数据表行。</param>
  140. void GetAllDataRows(List<T> results);
  141. /// <summary>
  142. /// 增加数据表行。
  143. /// </summary>
  144. /// <param name="dataRowString">要解析的数据表行字符串。</param>
  145. /// <param name="userData">用户自定义数据。</param>
  146. /// <returns>是否增加数据表行成功。</returns>
  147. bool AddDataRow(string dataRowString, object userData);
  148. /// <summary>
  149. /// 增加数据表行。
  150. /// </summary>
  151. /// <param name="dataRowBytes">要解析的数据表行二进制流。</param>
  152. /// <param name="startIndex">数据表行二进制流的起始位置。</param>
  153. /// <param name="length">数据表行二进制流的长度。</param>
  154. /// <param name="userData">用户自定义数据。</param>
  155. /// <returns>是否增加数据表行成功。</returns>
  156. bool AddDataRow(byte[] dataRowBytes, int startIndex, int length, object userData);
  157. /// <summary>
  158. /// 移除指定数据表行。
  159. /// </summary>
  160. /// <param name="id">要移除数据表行的编号。</param>
  161. /// <returns>是否移除数据表行成功。</returns>
  162. bool RemoveDataRow(int id);
  163. /// <summary>
  164. /// 清空所有数据表行。
  165. /// </summary>
  166. void RemoveAllDataRows();
  167. }
  168. }