cset.cs

小型项目组用的工作日志记录系统

/*
 * CSet.cs
 * 
 * 作者：邱观琛
 * 创建时间：2002-5-7
 * 最后修改：2002-6-28
 * 
 * 
 * 提供一些主要涉及到集合（指数组、ArrayList或DataView的单一字段）操作的函数，
 * 包括集合中元素的查找、统计、收集和其他处理等。
 * 
 */

using System;
using System.Data;
using System.Collections;

namespace CFC
{
	/// <summary>
	/// 提供一些主要涉及到集合操作的函数。
	/// </summary>
	public class CSet
	{
		private CSet()
		{
		}


		#region 在各种集合中查找单个元素的位置

		#region public static int IndexOf(object Element, DataView dv, string FieldName) : 在DataView中所有记录在指定字段上的值的集合内查找某一对象的位置
		/// <summary>
		/// 在DataView中所有记录在指定字段上的值的集合内查找某一对象，返回该对象的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的对象</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名称</param>
		/// <returns>被查找的对象的位置</returns>
		public static int IndexOf(object Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (Element.Equals(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(string Element, DataView dv, string FieldName) : 在DataView中所有记录在指定字段上的值的集合内查找某一字符串的位置
		/// <summary>
		/// 在DataView中所有记录在指定字段上的值的集合内查找某一字符串，返回该字符串的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的字符串</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名称</param>
		/// <returns>被查找的字符串的位置</returns>
		public static int IndexOf(string Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element.Equals(dv[i][FieldName].ToString())) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(int Element, DataView dv, string FieldName) : 在DataView中所有记录在指定字段上的值的集合内查找某一整数的位置
		/// <summary>
		/// 在DataView中所有记录在指定字段上的值的集合内查找某一整数，返回该整数的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的整数</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名称</param>
		/// <returns>被查找的整数的位置</returns>
		public static int IndexOf(int Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToInt16(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(double Element, DataView dv, string FieldName) : 在DataView中所有记录在指定字段上的值的集合内查找某一double数的位置
		/// <summary>
		/// 在DataView中所有记录在指定字段上的值的集合内查找某一double数，返回该double数的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的double数</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名称</param>
		/// <returns>被查找的double数的位置</returns>
		public static int IndexOf(double Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToDouble(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(decimal Element, DataView dv, string FieldName) : 在DataView中所有记录在指定字段上的值的集合内查找某一decimal数的位置
		/// <summary>
		/// 在DataView中所有记录在指定字段上的值的集合内查找某一decimal数，返回该decimal数的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的decimal数</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名称</param>
		/// <returns>被查找的decimal数的位置</returns>
		public static int IndexOf(decimal Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToDecimal(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion

		#endregion


		#region 收集DataView中所有记录在指定字段上的值

		#region public static Array Collect(DataView dv, string FieldName, Type ElementType) : 将DataView中所有记录在指定字段上的值收集到一个数组里面
		/// <summary>
		/// 将DataView中所有记录在指定字段上的值收集到一个数组里面。
		/// </summary>
		/// <param name="dv">需要收集的DataView</param>
		/// <param name="FieldName">需要收集的字段名</param>
		/// <param name="ElementType">生成数组的元素的类型，亦即DataView的指定字段的类型</param>
		/// <returns>收集结果</returns>
		public static Array Collect(DataView dv, string FieldName, Type ElementType)
		{
			Array Result = Array.CreateInstance(ElementType,dv.Count);
			for (int i=0; i<dv.Count; i++)
			{
				Result.SetValue(dv[i][FieldName],i);
			}
			return Result;
		}
		#endregion


		#region public static ArrayList Collect(DataView dv, string FieldName) : 将DataView中所有记录在指定字段上的值收集到一个ArrayList里面
		/// <summary>
		/// 将DataView中所有记录在指定字段上的值收集到一个ArrayList里面。
		/// </summary>
		/// <param name="dv">需要收集的DataView</param>
		/// <param name="FieldName">需要收集的字段名</param>
		/// <returns>收集结果</returns>
		public static ArrayList Collect(DataView dv, string FieldName)
		{
			ArrayList Result = new ArrayList(dv.Count);
			for (int i=0; i<dv.Count; i++)
			{
				Result.Add(dv[i][FieldName]);
			}
			return Result;
		}
		#endregion

		#endregion


		#region 统计集合中所有元素的总和

		#region public static int Sum(int[] Values) : 统计整数数组的元素的总和
		/// <summary>
		/// 统计整数数组的元素的总和。
		/// </summary>
		/// <param name="Values">需要统计的整数数组</param>
		/// <returns>统计结果</returns>
		public static int Sum(int[] Values)
		{
			int Result = 0;;
			foreach (int Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static double Sum(double[] Values) : 统计double数组的元素的总和
		/// <summary>
		/// 统计double数组的元素的总和。
		/// </summary>
		/// <param name="Values">需要统计的double数组</param>
		/// <returns>统计结果</returns>
		public static double Sum(double[] Values)
		{
			double Result = 0;;
			foreach (double Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static decimal Sum(decimal[] Values) : 统计decimal数组的元素的总和
		/// <summary>
		/// 统计decimal数组的元素的总和。
		/// </summary>
		/// <param name="Values">需要统计的decimal数组</param>
		/// <returns>统计结果</returns>
		public static decimal Sum(decimal[] Values)
		{
			decimal Result = 0;;
			foreach (decimal Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static int Sum(DataView dv, string FieldName, int DefaultValue) : 统计DataView中所有记录在指定字段上的值的总和
		/// <summary>
		/// 统计DataView中所有记录在指定字段上的值的总和，该字段必须为整型。