/// <summary> /// 转换当前 16 进制字符串为字节数组。 /// </summary> /// <param name="hexStr">由 16 进制字符构成的字符串。</param> /// <returns>转换后的字节数组。</returns> /// <exception cref="ArgumentNullException">当 <paramref name="hexStr"/> 为空引用(<c>null</c>)时抛出。</exception> /// <exception cref="ArgumentEmptyException">当 <pramref name="hexStr"/> 为空字符串(<see cref="String.Empty"/>)时抛出。</exception> /// <exception cref="InvalidCastException">当源字符串内容不符合十六进制字符规则时抛出。请参考 <see cref="IsHexString(string)"/> 方法。</exception> public static byte[] ToBytes(this string hexStr) { #region Parameter's Check ParamCheck.NotEmptyOrNull(hexStr, nameof(hexStr)); #endregion // 检查字符串是否由 16 进制字符构成。 if (!hexStr.IsHexString()) { throw new InvalidCastException(Properties.Resource.HexStringInvalid); } int byteCount = hexStr.Length / 2; // 求得转换后的字节数组元素总数。 byte[] bytes = new byte[byteCount]; // 存储转换后的字节数组。 for (int i = 0; i < hexStr.Length; i++) { string hex = hexStr.Substring(i++, 2); // 取得二个字符,并使用字符计算加一。 bytes[i / 2] = byte.Parse(hex, NumberStyles.AllowHexSpecifier, CultureInfo.InvariantCulture); } return(bytes); }
/// <summary> /// <para>返回一个布尔值,指示 <paramref name="type"/> 是否实现了 <paramref name="ifType"/> 代表的接口。</para> /// </summary> /// <param name="type">将要检查的类型。</param> /// <param name="ifType">预期的接口类型。</param> /// <returns>如果 <paramref name="type"/> 实现了 <paramref name="ifType"/> 代表的接口时返回真(<c>true</c>),否则返回假(<c>false</c>)。</returns> /// <remarks>注,如果 <paramref name="ifType"/> 不是一个接口类型,那么将返回一个假(<c>false</c>)。</remarks> /// <exception cref="ArgumentNullException">当 <paramref name="type"/> 或 <paramref name="ifType"/> 为空引用(<c>null</c>)时引发。</exception> public static bool IsImplFrom(this Type type, Type ifType) { #region Parameter Check ParamCheck.NotNull(type, nameof(type)); ParamCheck.NotNull(ifType, nameof(ifType)); #endregion var typeInfo = type.GetTypeInfo(); var ifTypeInfo = ifType.GetTypeInfo(); // 如果预期类型不是一个接口, if (!ifTypeInfo.IsInterface) { return(false); } // 如果被测类型是泛型, if (typeInfo.IsGenericType) { return(typeInfo.GetGenericTypeDefinition() == ifType || ifTypeInfo.IsAssignableFrom(typeInfo)); } // 被测类型是一般类型, return(ifTypeInfo.IsAssignableFrom(typeInfo) || typeInfo.GetInterfaces().Any(ifif => { var ififInfo = ifif.GetTypeInfo(); // 如果是泛型则比较泛型定义,否则比较类型。 return ififInfo.IsGenericType ? ififInfo.GetGenericTypeDefinition() == ifType : ifif == ifType; })); }
/// <summary> /// <para>检查当前字符串是否是由 16 进制字符构成的。</para> /// <para> /// 检查内容包含: /// <list type="number"> /// <item>1. 检查字符串的总字符个数是 2 的整数倍。</item> /// <item>2. 检查字符串中的构成字符为 0-9,A-F, a-f</item> /// </list> /// </para> /// </summary> /// <param name="str">将被检查的字符串。</param> /// <returns>如果符合返回 <c>ture</c>;否则返回 <c>false</c>。</returns> /// <exception cref="ArgumentNullException">当 <paramref name="str"/> 为空引用(<c>null</c>)时抛出。</exception> /// <exception cref="ArgumentEmptyException">当 <paramref name="str"/> 为空字符串(<see cref="String.Empty"/>)时抛出。</exception> /// <remarks> /// 本方法仅在字符串内容上保证是符合 16 进制的规则;但不保证转换成的 byte[] 一定符合业务要求。 /// </remarks> public static bool IsHexString(this string str) { #region Parameter's Check ParamCheck.NotEmptyOrNull(str, nameof(str)); #endregion // 如果不是 2 的整数倍。 if (str.Length % 2 > 0) { return(false); } // 循环检查构成的字符。 foreach (char c in str) { if (c >= 'a' && c <= 'f') { continue; } if (c >= 'A' && c <= 'F') { continue; } if (c >= '0' && c <= '9') { continue; } return(false); } return(true); }
/// <summary> /// 检查 <paramref name="value"/>,如果为空引用(<c>null</c>)则抛出 <see cref="ArgumentNullException"/>。 /// </summary> /// <typeparam name="T">指定 <paramref name="value"/> 的类型。</typeparam> /// <param name="value">被检查值。</param> /// <param name="name">被检查值在方法定义中的名称。</param> /// <exception cref="ArgumentNullException">如果被检查值为空引用(<c>null</c>)则抛出。</exception> public static void NotNull <T>(T value, string name) where T : class { if (ReferenceEquals(value, null)) { ParamCheck.NotEmptyOrNull(name, nameof(name)); throw new ArgumentNullException(name); } }
/// <summary> /// <para>检查 <paramref name="value"/> 是否为空全局唯一标识符(<see cref="Guid.Empty"/>)。</para> /// </summary> /// <param name="value">将要被检查的参数值。</param> /// <param name="name">被检查参数值的名称。</param> /// <exception cref="ArgumentNullException">当 <paramref name="name"/> 为空引用(<c>null</c>)时引发。</exception> /// <exception cref="ArgumentEmptyException">当 <paramref name="value"/> 为空全局唯一标识符(<see cref="Guid.Empty"/>) 或 <paramref name="name"/> 为空字符串(<see cref="String.Empty"/>)时引发。</exception> public static void NotEmpty(Guid value, string name) { if (Guid.Equals(value, Guid.Empty)) { ParamCheck.NotEmptyOrNull(name, nameof(name)); throw new ArgumentEmptyException(name); } }
/// <summary> /// <para>返回一个布尔值,指示 <paramref name="type"/> 是否是从 <paramref name="baseType"/> 类型派生(或实现)的。</para> /// <para>如果 <paramref name="type"/> 继承于 <paramref name="baseType"/> 则返回真(<c>true</c>)。</para> /// <para>如果 <paramref name="type"/> 实现了 <paramref name="baseType"/>(当是一个接口类型时)则返回真(<c>true</c>)</para> /// </summary> /// <param name="type">将要检查的类型。</param> /// <param name="baseType">预期的基类或接口。</param> /// <returns>如果 <paramref name="type"/> 是从 <paramref name="baseType"/> 派生或实现了 <paramref name="baseType"/>(当是一个接口类型时)时返回真(<c>true</c>);否则返回假(<c>false</c>)。</returns> /// <exception cref="ArgumentNullException">当 <paramref name="type"/> 或 <paramref name="baseType"/> 为空引用(<c>null</c>)时引发。</exception> public static bool IsDerivedFrom(this Type type, Type baseType) { #region Parameter Check ParamCheck.NotNull(type, nameof(type)); ParamCheck.NotNull(baseType, nameof(baseType)); #endregion TypeInfo baseTypeInfo = baseType.GetTypeInfo(); // 如果预期类型是一个接口, if (baseTypeInfo.IsInterface) { return(type.IsImplFrom(baseType)); } TypeInfo typeInfo = type.GetTypeInfo(); // 如果预期类型不是泛型声明, if (!baseTypeInfo.IsGenericTypeDefinition) { return(baseTypeInfo.IsAssignableFrom(type)); } else { // 否则, // 如果被测类型是泛型, if (typeInfo.IsGenericType) { return(baseTypeInfo.IsAssignableFrom(typeInfo.GetGenericTypeDefinition())); } else // 否则 { bool result = baseTypeInfo.IsAssignableFrom(typeInfo); if (result) { return(true); } // 查询基类, var typeOfBase = typeInfo.BaseType; while (typeOfBase != typeof(object)) { result = typeOfBase.IsDerivedFrom(baseType); if (result) { break; } typeOfBase = typeOfBase.GetTypeInfo().BaseType; } return(result); } } }
/// <summary> /// 循环对 <paramref name="source"/> 内的每个元素执行 <paramref name="func"/> 定义的操作,并返回包含处理后元素的 <see cref="IEnumerable{T}"/>。 /// </summary> /// <typeparam name="T"><paramref name="source"/> 中元素的类型。</typeparam> /// <param name="source">包含将要处理元素的 <see cref="IEnumerable{T}"/>。</param> /// <param name="func">将要应用于元素的方法。</param> /// <returns>包含处理后元素的 <see cref="IEnumerable{T}"/>。</returns> /// <exception cref="NullReferenceException">当 <paramref name="source"/> 为空引用(<c>null</c>)时引发。</exception> public static IEnumerable <T> ForEach <T>(this IEnumerable <T> source, Func <T, T> func) { #region Param Check ParamCheck.NotNull(source, nameof(source)); #endregion return(source.Select(item => func.Invoke(item)).ToList()); }
/// <summary> /// 循环对 <paramref name="source"/> 内的每个元素执行 <paramref name="action"/> 定义的操作。 /// </summary> /// <typeparam name="T"><paramref name="source"/> 中元素的类型。</typeparam> /// <param name="source">包含将要处理元素的 <see cref="IEnumerable{T}"/>。</param> /// <param name="action">将要应用于元素的方法。</param> /// <exception cref="NullReferenceException">当 <paramref name="source"/> 为空引用(<c>null</c>)时引发。</exception> public static void ForEach <T>(this IEnumerable <T> source, Action <T> action) { #region Param Check ParamCheck.NotNull(source, nameof(source)); #endregion foreach (T item in source) { action.Invoke(item); } }
/// <summary> /// 转换当前字节数组为 16 进制字符构成的字符串。 /// </summary> /// <param name="bin">待转换的字节数组。</param> /// <returns>转换后的字符串。</returns> /// <exception cref="ArgumentNullException">当 <paramref name="bin"/> 为空引用(<c>null</c>)时抛出。</exception> /// <exception cref="ArgumentEmptyException">当 <paramref name="bin"/> 为空集合时抛出。</exception> public static string ToHexString(this byte[] bin) { #region Parameter's Check ParamCheck.NotEmptyOrNull(bin, nameof(bin)); #endregion StringBuilder hexStr = new StringBuilder(); foreach (byte b in bin) { hexStr.Append(b.ToString("X2", CultureInfo.InvariantCulture)); } return(hexStr.ToString()); }
/// <summary> /// 检查 <paramref name="value"/>,如果没有任何元素存在则抛出 <see cref="ArgumentEmptyException"/>。 /// </summary> /// <param name="value">被检查集合值。</param> /// <param name="name">被检查值在方法定义中的名称。</param> public static void NotEmptyOrNull(ICollection value, string name) { ArgumentException e = null; if (ReferenceEquals(value, null)) { e = new ArgumentNullException(name); } else if (value.Count == 0) { e = new ArgumentEmptyException(name); } if (e != null) { ParamCheck.NotEmptyOrNull(name, nameof(name)); throw e; } }