123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192 |
- //------------------------------------------------------------
- // Game Framework
- // Copyright © 2013-2021 loyalsoft. All rights reserved.
- // Homepage: http://www.game7000.com/
- // Feedback: http://www.game7000.com/
- //------------------------------------------------------------
- using System;
- using System.Collections.Generic;
- namespace GameFramework.DataTable
- {
- /// <summary>
- /// 数据表接口。
- /// </summary>
- /// <typeparam name="T">数据表行的类型。</typeparam>
- public interface IDataTable<T> : IEnumerable<T> where T : IDataRow
- {
- /// <summary>
- /// 获取数据表名称。
- /// </summary>
- string Name
- {
- get;
- }
- /// <summary>
- /// 获取数据表完整名称。
- /// </summary>
- string FullName
- {
- get;
- }
- /// <summary>
- /// 获取数据表行的类型。
- /// </summary>
- Type Type
- {
- get;
- }
- /// <summary>
- /// 获取数据表行数。
- /// </summary>
- int Count
- {
- get;
- }
- /// <summary>
- /// 获取数据表行。
- /// </summary>
- /// <param name="id">数据表行的编号。</param>
- /// <returns>数据表行。</returns>
- T this[int id]
- {
- get;
- }
- /// <summary>
- /// 获取编号最小的数据表行。
- /// </summary>
- T MinIdDataRow
- {
- get;
- }
- /// <summary>
- /// 获取编号最大的数据表行。
- /// </summary>
- T MaxIdDataRow
- {
- get;
- }
- /// <summary>
- /// 检查是否存在数据表行。
- /// </summary>
- /// <param name="id">数据表行的编号。</param>
- /// <returns>是否存在数据表行。</returns>
- bool HasDataRow(int id);
- /// <summary>
- /// 检查是否存在数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <returns>是否存在数据表行。</returns>
- bool HasDataRow(Predicate<T> condition);
- /// <summary>
- /// 获取数据表行。
- /// </summary>
- /// <param name="id">数据表行的编号。</param>
- /// <returns>数据表行。</returns>
- T GetDataRow(int id);
- /// <summary>
- /// 获取符合条件的数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <returns>符合条件的数据表行。</returns>
- /// <remarks>当存在多个符合条件的数据表行时,仅返回第一个符合条件的数据表行。</remarks>
- T GetDataRow(Predicate<T> condition);
- /// <summary>
- /// 获取符合条件的数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <returns>符合条件的数据表行。</returns>
- T[] GetDataRows(Predicate<T> condition);
- /// <summary>
- /// 获取符合条件的数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <param name="results">符合条件的数据表行。</param>
- void GetDataRows(Predicate<T> condition, List<T> results);
- /// <summary>
- /// 获取排序后的数据表行。
- /// </summary>
- /// <param name="comparison">要排序的条件。</param>
- /// <returns>排序后的数据表行。</returns>
- T[] GetDataRows(Comparison<T> comparison);
- /// <summary>
- /// 获取排序后的数据表行。
- /// </summary>
- /// <param name="comparison">要排序的条件。</param>
- /// <param name="results">排序后的数据表行。</param>
- void GetDataRows(Comparison<T> comparison, List<T> results);
- /// <summary>
- /// 获取排序后的符合条件的数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <param name="comparison">要排序的条件。</param>
- /// <returns>排序后的符合条件的数据表行。</returns>
- T[] GetDataRows(Predicate<T> condition, Comparison<T> comparison);
- /// <summary>
- /// 获取排序后的符合条件的数据表行。
- /// </summary>
- /// <param name="condition">要检查的条件。</param>
- /// <param name="comparison">要排序的条件。</param>
- /// <param name="results">排序后的符合条件的数据表行。</param>
- void GetDataRows(Predicate<T> condition, Comparison<T> comparison, List<T> results);
- /// <summary>
- /// 获取所有数据表行。
- /// </summary>
- /// <returns>所有数据表行。</returns>
- T[] GetAllDataRows();
- /// <summary>
- /// 获取所有数据表行。
- /// </summary>
- /// <param name="results">所有数据表行。</param>
- void GetAllDataRows(List<T> results);
- /// <summary>
- /// 增加数据表行。
- /// </summary>
- /// <param name="dataRowString">要解析的数据表行字符串。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否增加数据表行成功。</returns>
- bool AddDataRow(string dataRowString, object userData);
- /// <summary>
- /// 增加数据表行。
- /// </summary>
- /// <param name="dataRowBytes">要解析的数据表行二进制流。</param>
- /// <param name="startIndex">数据表行二进制流的起始位置。</param>
- /// <param name="length">数据表行二进制流的长度。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否增加数据表行成功。</returns>
- bool AddDataRow(byte[] dataRowBytes, int startIndex, int length, object userData);
- /// <summary>
- /// 移除指定数据表行。
- /// </summary>
- /// <param name="id">要移除数据表行的编号。</param>
- /// <returns>是否移除数据表行成功。</returns>
- bool RemoveDataRow(int id);
- /// <summary>
- /// 清空所有数据表行。
- /// </summary>
- void RemoveAllDataRows();
- }
- }
|