using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
#if !NETSTANDARD2_0
using System.Windows.Forms;
#endif
using System.IO;
using System.Runtime.Serialization.Formatters.Binary;
using System.Security.Cryptography;
using System.Drawing;
namespace MECF.Framework.RT.Core.IoProviders.Siemens.Transfer
{
///
/// 一个软件基础类,提供常用的一些静态方法 ->
/// A software-based class that provides some common static methods
///
public class SoftBasic
{
#region MD5 Calculate
///
/// 获取文件的md5码 -> Get the MD5 code of the file
///
/// 文件的路径,既可以是完整的路径,也可以是相对的路径 -> The path to the file
/// Md5字符串
///
/// 下面举例实现获取一个文件的md5码
///
///
public static string CalculateFileMD5( string filePath )
{
string str_md5 = string.Empty;
using (FileStream fs = new FileStream( filePath, FileMode.Open, FileAccess.Read ))
{
str_md5 = CalculateStreamMD5( fs );
}
return str_md5;
}
///
/// 获取数据流的md5码 -> Get the MD5 code for the data stream
///
/// 数据流,可以是内存流,也可以是文件流
/// Md5字符串
///
/// 下面举例实现获取一个流的md5码
///
///
public static string CalculateStreamMD5( Stream stream )
{
byte[] bytes_md5 = null;
using (MD5 md5 = new MD5CryptoServiceProvider( ))
{
bytes_md5 = md5.ComputeHash( stream );
}
return BitConverter.ToString( bytes_md5 ).Replace( "-", "" );
}
///
/// 获取文本字符串信息的Md5码,编码为UTF8
///
/// 文本数据信息
/// Md5字符串
public static string CalculateStreamMD5( string data )
{
return CalculateStreamMD5( data, Encoding.UTF8 );
}
///
/// 获取文本字符串信息的Md5码,使用指定的编码
///
/// 文本数据信息
/// 编码信息
/// Md5字符串
public static string CalculateStreamMD5( string data, Encoding encode )
{
string str_md5 = string.Empty;
using (MD5 md5 = new MD5CryptoServiceProvider( ))
{
byte[] bytes_md5 = md5.ComputeHash( encode.GetBytes( data ) );
str_md5 = BitConverter.ToString( bytes_md5 ).Replace( "-", "" );
}
return str_md5;
}
#if !NETSTANDARD2_0
///
/// 获取内存图片的md5码 -> Get the MD5 code of the memory picture
///
/// 内存图片
/// Md5字符串
///
/// 下面举例实现获取一个图像的md5码
///
///
public static string CalculateStreamMD5(Bitmap bitmap)
{
MemoryStream ms = new MemoryStream();
bitmap.Save(ms, bitmap.RawFormat);
MD5 md5 = new MD5CryptoServiceProvider();
byte[] bytes_md5 = md5.ComputeHash(ms);
ms.Dispose();
return BitConverter.ToString(bytes_md5).Replace("-", "");
}
#endif
#endregion
#region DataSize Format
///
/// 从一个字节大小返回带单位的描述
///
/// 实际的大小值
/// 最终的字符串值
///
/// 比如说我们获取了文件的长度,这个长度可以来自于本地,也可以来自于数据库查询
///
///
public static string GetSizeDescription( long size )
{
if (size < 1000)
{
return size + " B";
}
else if (size < 1000 * 1000)
{
float data = (float)size / 1024;
return data.ToString( "F2" ) + " Kb";
}
else if (size < 1000 * 1000 * 1000)
{
float data = (float)size / 1024 / 1024;
return data.ToString( "F2" ) + " Mb";
}
else
{
float data = (float)size / 1024 / 1024 / 1024;
return data.ToString( "F2" ) + " Gb";
}
}
#endregion
#region TimeSpan Format
///
/// 从一个时间差返回带单位的描述
///
/// 实际的时间差
/// 最终的字符串值
///
/// 比如说我们获取了一个时间差信息
///
///
public static string GetTimeSpanDescription( TimeSpan ts )
{
if (ts.TotalSeconds <= 60)
{
return (int)ts.TotalSeconds + " 秒";
}
else if (ts.TotalMinutes <= 60)
{
return ts.TotalMinutes.ToString( "F1" ) + " 分钟";
}
else if (ts.TotalHours <= 24)
{
return ts.TotalHours.ToString( "F1" ) + " 小时";
}
else
{
return ts.TotalDays.ToString( "F1" ) + " 天";
}
}
#endregion
#region Array Expaned
///
/// 一个通用的数组新增个数方法,会自动判断越界情况,越界的情况下,会自动的截断或是填充 ->
/// A common array of new methods, will automatically determine the cross-border situation, in the case of cross-border, will be automatically truncated or filled
///
/// 数据类型
/// 原数据
/// 等待新增的数据
/// 原数据的最大值
///
///
///
public static void AddArrayData( ref T[] array, T[] data, int max )
{
if (data == null) return; // 数据为空
if (data.Length == 0) return; // 数据长度为空
if (array.Length == max)
{
Array.Copy( array, data.Length, array, 0, array.Length - data.Length );
Array.Copy( data, 0, array, array.Length - data.Length, data.Length );
}
else
{
if ((array.Length + data.Length) > max)
{
T[] tmp = new T[max];
for (int i = 0; i < (max - data.Length); i++)
{
tmp[i] = array[i + (array.Length - max + data.Length)];
}
for (int i = 0; i < data.Length; i++)
{
tmp[tmp.Length - data.Length + i] = data[i];
}
// 更新数据
array = tmp;
}
else
{
T[] tmp = new T[array.Length + data.Length];
for (int i = 0; i < array.Length; i++)
{
tmp[i] = array[i];
}
for (int i = 0; i < data.Length; i++)
{
tmp[tmp.Length - data.Length + i] = data[i];
}
array = tmp;
}
}
}
///
/// 将一个数组进行扩充到指定长度,或是缩短到指定长度 ->
/// Extend an array to a specified length, or shorten to a specified length or fill
///
/// 数组的类型
/// 原先数据的数据
/// 新数组的长度
/// 新数组长度信息
///
///
///
public static T[] ArrayExpandToLength( T[] data, int length )
{
if (data == null) return new T[length];
if (data.Length == length) return data;
T[] buffer = new T[length];
Array.Copy( data, buffer, Math.Min( data.Length, buffer.Length ) );
return buffer;
}
///
/// 将一个数组进行扩充到偶数长度 ->
/// Extend an array to even lengths
///
/// 数组的类型
/// 原先数据的数据
/// 新数组长度信息
///
///
///
public static T[] ArrayExpandToLengthEven( T[] data )
{
if (data == null) return new T[0];
if (data.Length % 2 == 1)
{
return ArrayExpandToLength( data, data.Length + 1 );
}
else
{
return data;
}
}
#endregion
#region Byte Array compare
///
/// 判断两个字节的指定部分是否相同 ->
/// Determines whether the specified portion of a two-byte is the same
///
/// 第一个字节
/// 第一个字节的起始位置
/// 第二个字节
/// 第二个字节的起始位置
/// 校验的长度
/// 返回是否相等
///
///
///
///
public static bool IsTwoBytesEquel( byte[] b1, int start1, byte[] b2, int start2, int length )
{
if (b1 == null || b2 == null) return false;
for (int i = 0; i < length; i++)
{
if (b1[i + start1] != b2[i + start2])
{
return false;
}
}
return true;
}
///
/// 判断两个字节的指定部分是否相同 ->
/// Determines whether the specified portion of a two-byte is the same
///
/// 第一个字节
/// 第二个字节
/// 返回是否相等
///
///
///
public static bool IsTwoBytesEquel( byte[] b1, byte[] b2)
{
if (b1 == null || b2 == null) return false;
if (b1.Length != b2.Length) return false;
return IsTwoBytesEquel( b1, 0, b2, 0, b1.Length );
}
///
/// 判断两个数据的令牌是否相等 ->
/// Determines whether the tokens of two data are equal
///
/// 字节数据
/// GUID数据
/// 返回是否相等
///
///
///
public static bool IsByteTokenEquel( byte[] head, Guid token )
{
return IsTwoBytesEquel( head, 12, token.ToByteArray( ), 0, 16 );
}
///
/// 判断两个数据的令牌是否相等 ->
/// Determines whether the tokens of two data are equal
///
/// 第一个令牌
/// 第二个令牌
/// 返回是否相等
public static bool IsTwoTokenEquel( Guid token1, Guid token2 )
{
return IsTwoBytesEquel( token1.ToByteArray( ), 0, token2.ToByteArray( ), 0, 16 );
}
#endregion
#region Enum About
///
/// 获取一个枚举类型的所有枚举值,可直接应用于组合框数据 ->
/// Gets all the enumeration values of an enumeration type that can be applied directly to the combo box data
///
/// 枚举的类型值
/// 枚举值数组
///
///
///
public static TEnum[] GetEnumValues( ) where TEnum : struct
{
return (TEnum[])Enum.GetValues( typeof( TEnum ) );
}
///
/// 从字符串的枚举值数据转换成真实的枚举值数据 ->
/// Convert enumeration value data from strings to real enumeration value data
///
/// 枚举的类型值
/// 枚举的字符串的数据值
/// 真实的枚举值
///
///
///
public static TEnum GetEnumFromString(string value ) where TEnum : struct
{
return (TEnum)Enum.Parse( typeof( TEnum ), value );
}
#endregion
#region Exception Message Format
#if !NETSTANDARD2_0
///
/// 显示一个完整的错误信息 ->
/// Displays a complete error message
///
/// 异常对象
/// 调用本方法可以显示一个异常的详细信息
///
public static void ShowExceptionMessage( Exception ex )
{
MessageBox.Show( GetExceptionMessage( ex ) );
}
///
/// 显示一个完整的错误信息,和额外的字符串描述信息 ->
/// Displays a complete error message, and additional string description information
///
/// 额外的描述信息
/// 调用本方法可以显示一个异常的详细信息
/// 异常对象
///
public static void ShowExceptionMessage( string extraMsg, Exception ex )
{
MessageBox.Show( GetExceptionMessage( extraMsg, ex ) );
}
#endif
///
/// 获取一个异常的完整错误信息 ->
/// Gets the complete error message for an exception
///
/// 异常对象
/// 完整的字符串数据
/// 获取异常的完整信息
/// ex不能为空
///
///
///
public static string GetExceptionMessage( Exception ex )
{
return ex.Message + Environment.NewLine + ex.StackTrace + Environment.NewLine + ex.TargetSite;
}
///
/// 获取一个异常的完整错误信息,和额外的字符串描述信息 ->
/// Gets the complete error message for an exception, and additional string description information
///
/// 额外的信息
/// 异常对象
/// 完整的字符串数据
///
///
///
///
public static string GetExceptionMessage( string extraMsg, Exception ex )
{
if (string.IsNullOrEmpty( extraMsg ))
{
return GetExceptionMessage( ex );
}
else
{
return extraMsg + Environment.NewLine + GetExceptionMessage( ex );
}
}
#endregion
#region Hex string and Byte[] transform
///
/// 字节数据转化成16进制表示的字符串 ->
/// Byte data into a string of 16 binary representations
///
/// 字节数组
/// 返回的字符串
///
///
///
///
public static string ByteToHexString( byte[] InBytes )
{
return ByteToHexString( InBytes, (char)0 );
}
///
/// 字节数据转化成16进制表示的字符串 ->
/// Byte data into a string of 16 binary representations
///
/// 字节数组
/// 分割符
/// 返回的字符串
///
///
///
///
public static string ByteToHexString( byte[] InBytes, char segment )
{
StringBuilder sb = new StringBuilder( );
foreach (byte InByte in InBytes)
{
if (segment == 0) sb.Append( string.Format( "{0:X2}", InByte ) );
else sb.Append( string.Format( "{0:X2}{1}", InByte, segment ) );
}
if (segment != 0 && sb.Length > 1 && sb[sb.Length - 1] == segment)
{
sb.Remove( sb.Length - 1, 1 );
}
return sb.ToString( );
}
///
/// 字符串数据转化成16进制表示的字符串 ->
/// String data into a string of 16 binary representations
///
/// 输入的字符串数据
/// 返回的字符串
///
public static string ByteToHexString( string InString )
{
return ByteToHexString( Encoding.Unicode.GetBytes( InString ) );
}
private static List hexCharList = new List( )
{
'0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'
};
///
/// 将16进制的字符串转化成Byte数据,将检测每2个字符转化,也就是说,中间可以是任意字符 ->
/// Converts a 16-character string into byte data, which will detect every 2 characters converted, that is, the middle can be any character
///
/// 十六进制的字符串,中间可以是任意的分隔符
/// 转换后的字节数组
/// 参数举例:AA 01 34 A8
///
///
///
public static byte[] HexStringToBytes( string hex )
{
hex = hex.ToUpper( );
MemoryStream ms = new MemoryStream( );
for (int i = 0; i < hex.Length; i++)
{
if ((i + 1) < hex.Length)
{
if (hexCharList.Contains( hex[i] ) && hexCharList.Contains( hex[i + 1] ))
{
// 这是一个合格的字节数据
ms.WriteByte( (byte)(hexCharList.IndexOf( hex[i] ) * 16 + hexCharList.IndexOf( hex[i + 1] )) );
i++;
}
}
}
byte[] result = ms.ToArray( );
ms.Dispose( );
return result;
}
#endregion
#region Byte Reverse By Word
///
/// 将byte数组按照双字节进行反转,如果为单数的情况,则自动补齐 ->
/// Reverses the byte array by double byte, or if the singular is the case, automatically
///
/// 输入的字节信息
/// 反转后的数据
///
///
///
public static byte[] BytesReverseByWord(byte[] inBytes )
{
if (inBytes == null) return null;
byte[] buffer = ArrayExpandToLengthEven( inBytes );
for (int i = 0; i < buffer.Length / 2; i++)
{
byte tmp = buffer[i * 2 + 0];
buffer[i * 2 + 0] = buffer[i * 2 + 1];
buffer[i * 2 + 1] = tmp;
}
return buffer;
}
#endregion
#region Byte[] and AsciiByte[] transform
///
/// 将原始的byte数组转换成ascii格式的byte数组 ->
/// Converts the original byte array to an ASCII-formatted byte array
///
/// 等待转换的byte数组
/// 转换后的数组
public static byte[] BytesToAsciiBytes( byte[] inBytes )
{
return Encoding.ASCII.GetBytes( ByteToHexString( inBytes ) );
}
///
/// 将ascii格式的byte数组转换成原始的byte数组 ->
/// Converts an ASCII-formatted byte array to the original byte array
///
/// 等待转换的byte数组
/// 转换后的数组
public static byte[] AsciiBytesToBytes( byte[] inBytes )
{
return HexStringToBytes( Encoding.ASCII.GetString( inBytes ) );
}
///
/// 从字节构建一个ASCII格式的数据内容
///
/// 数据
/// ASCII格式的字节数组
public static byte[] BuildAsciiBytesFrom( byte value )
{
return Encoding.ASCII.GetBytes( value.ToString( "X2" ) );
}
///
/// 从short构建一个ASCII格式的数据内容
///
/// 数据
/// ASCII格式的字节数组
public static byte[] BuildAsciiBytesFrom( short value )
{
return Encoding.ASCII.GetBytes( value.ToString( "X4" ) );
}
///
/// 从ushort构建一个ASCII格式的数据内容
///
/// 数据
/// ASCII格式的字节数组
public static byte[] BuildAsciiBytesFrom( ushort value )
{
return Encoding.ASCII.GetBytes( value.ToString( "X4" ) );
}
#endregion
#region Bool[] and byte[] transform
///
/// 将bool数组转换到byte数组 ->
/// Converting a bool array to a byte array
///
/// bool数组
/// 转换后的字节数组
///
///
///
public static byte[] BoolArrayToByte( bool[] array )
{
if (array == null) return null;
int length = array.Length % 8 == 0 ? array.Length / 8 : array.Length / 8 + 1;
byte[] buffer = new byte[length];
for (int i = 0; i < array.Length; i++)
{
int index = i / 8;
int offect = i % 8;
byte temp = 0;
switch (offect)
{
case 0: temp = 0x01; break;
case 1: temp = 0x02; break;
case 2: temp = 0x04; break;
case 3: temp = 0x08; break;
case 4: temp = 0x10; break;
case 5: temp = 0x20; break;
case 6: temp = 0x40; break;
case 7: temp = 0x80; break;
default: break;
}
if (array[i]) buffer[index] += temp;
}
return buffer;
}
///
/// 从Byte数组中提取位数组,length代表位数 ->
/// Extracts a bit array from a byte array, length represents the number of digits
///
/// 原先的字节数组
/// 想要转换的长度,如果超出自动会缩小到数组最大长度
/// 转换后的bool数组
///
///
///
public static bool[] ByteToBoolArray( byte[] InBytes, int length )
{
if (InBytes == null) return null;
if (length > InBytes.Length * 8) length = InBytes.Length * 8;
bool[] buffer = new bool[length];
for (int i = 0; i < length; i++)
{
int index = i / 8;
int offect = i % 8;
byte temp = 0;
switch (offect)
{
case 0: temp = 0x01; break;
case 1: temp = 0x02; break;
case 2: temp = 0x04; break;
case 3: temp = 0x08; break;
case 4: temp = 0x10; break;
case 5: temp = 0x20; break;
case 6: temp = 0x40; break;
case 7: temp = 0x80; break;
default: break;
}
if ((InBytes[index] & temp) == temp)
{
buffer[i] = true;
}
}
return buffer;
}
///
/// 从Byte数组中提取所有的位数组 ->
/// Extracts a bit array from a byte array, length represents the number of digits
///
/// 原先的字节数组
/// 转换后的bool数组
///
///
///
public static bool[] ByteToBoolArray( byte[] InBytes )
{
if (InBytes == null) return null;
return ByteToBoolArray( InBytes, InBytes.Length * 8 );
}
#endregion
#region Byte[] Splice
///
/// 拼接2个字节数组成一个数组 ->
/// Splicing 2 bytes to to an array
///
/// 数组一
/// 数组二
/// 拼接后的数组
///
///
///
public static byte[] SpliceTwoByteArray( byte[] bytes1, byte[] bytes2 )
{
if (bytes1 == null && bytes2 == null) return null;
if (bytes1 == null) return bytes2;
if (bytes2 == null) return bytes1;
byte[] buffer = new byte[bytes1.Length + bytes2.Length];
bytes1.CopyTo( buffer, 0 );
bytes2.CopyTo( buffer, bytes1.Length );
return buffer;
}
///
/// 将一个byte数组的前面指定位数移除,返回新的一个数组 ->
/// Removes the preceding specified number of bits in a byte array, returning a new array
///
/// 字节数组
/// 等待移除的长度
/// 新的数据
///
///
///
public static byte[] BytesArrayRemoveBegin( byte[] value, int length )
{
return BytesArrayRemoveDouble( value, length, 0 );
}
///
/// 将一个byte数组的后面指定位数移除,返回新的一个数组 ->
/// Removes the specified number of digits after a byte array, returning a new array
///
/// 字节数组
/// 等待移除的长度
/// 新的数据
///
///
///
public static byte[] BytesArrayRemoveLast( byte[] value, int length )
{
return BytesArrayRemoveDouble( value, 0, length );
}
///
/// 将一个byte数组的前后移除指定位数,返回新的一个数组 ->
/// Removes a byte array before and after the specified number of bits, returning a new array
///
/// 字节数组
/// 前面的位数
/// 后面的位数
/// 新的数据
///
///
///
public static byte[] BytesArrayRemoveDouble( byte[] value, int leftLength, int rightLength )
{
if (value == null) return null;
if (value.Length <= (leftLength + rightLength)) return new byte[0];
byte[] buffer = new byte[value.Length - leftLength - rightLength];
Array.Copy( value, leftLength, buffer, 0, buffer.Length );
return buffer;
}
#endregion
#region Deep Clone
///
/// 使用序列化反序列化深度克隆一个对象,该对象需要支持序列化特性 ->
/// Cloning an object with serialization deserialization depth that requires support for serialization attributes
///
/// 源对象,支持序列化
/// 新的一个实例化的对象
///
///
///
///
/// 参数必须实现序列化的特性
///
///
///
///
///
public static object DeepClone( object oringinal )
{
using (System.IO.MemoryStream stream = new System.IO.MemoryStream( ))
{
BinaryFormatter formatter = new BinaryFormatter( )
{
Context = new System.Runtime.Serialization.StreamingContext( System.Runtime.Serialization.StreamingContextStates.Clone )
};
formatter.Serialize( stream, oringinal );
stream.Position = 0;
return formatter.Deserialize( stream );
}
}
#endregion
#region Unique String Get
///
/// 获取一串唯一的随机字符串,长度为20,由Guid码和4位数的随机数组成,保证字符串的唯一性 ->
/// Gets a string of unique random strings with a length of 20, consisting of a GUID code and a 4-digit random number to guarantee the uniqueness of the string
///
/// 随机字符串数据
///
///
///
public static string GetUniqueStringByGuidAndRandom( )
{
Random random = new Random( );
return Guid.NewGuid( ).ToString( "N" ) + random.Next( 1000, 10000 );
}
#endregion
}
}