Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/symbolspace/symbol
Symbol .net library
https://github.com/symbolspace/symbol
api cloud image-recognition json netcore socket symbol verifycode web
Last synced: 4 days ago
JSON representation
Symbol .net library
- Host: GitHub
- URL: https://github.com/symbolspace/symbol
- Owner: symbolspace
- License: mit
- Created: 2018-11-21T15:33:01.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-08T07:48:27.000Z (10 months ago)
- Last Synced: 2024-12-10T09:53:21.693Z (12 days ago)
- Topics: api, cloud, image-recognition, json, netcore, socket, symbol, verifycode, web
- Language: C#
- Size: 970 KB
- Stars: 17
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Symbol project
## Download
* Symbol.dll [](https://www.nuget.org/packages/Symbol/)
* Symbol.Net.dll [](https://www.nuget.org/packages/Symbol.Net/)
* Symbol.Web.dll [](https://www.nuget.org/packages/Symbol.Web/)
* Symbol.Logger.NLog.dll [](https://www.nuget.org/packages/Symbol.Logger.NLog/)
* Symbol.Logger.Serilog.dll [](https://www.nuget.org/packages/Symbol.Logger.Serilog/)
## Release Notes [More](https://github.com/symbolspace/Symbol/wiki/Version-history)
## Iteration plan
* Symbol.Cloud 移植；
* Symbol.Cloud 微服务家族；
* Symbol.Cloud 多种实现方式；
## Support runtime
* .net framework 2.0;
* .net framework 3.5;
* .net framework 4.0;
* .net framework 4.5;
* .net framework 4.5.2;
* .net framework 4.6;
* .net framework 4.6.1;
* .net framework 4.7;
* .net framework 4.8;
* .net standard 2.0
* .net core app 3.1;
* .net 5.0;
* .net 6.0;
* .net 7.0;
* .net 8.0;
## Wiki
* [Symbol.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.dll)
* [Symbol.Data.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.Data.dll)
* [Symbol.Net.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.Net.dll)
* [Symbol.Web.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.Web.dll)
* [Symbol.Drawing.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.Drawing.dll)
* [Symbol.IO.Packing.TreePackage.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.IO.Packing.TreePackage.dll)
* [Symbol.ImageRecognition.Verification.dll](https://github.com/symbolspace/Symbol/wiki/Symbol.ImageRecognition.Verification.dll)
## Contribute
We gladly accept community contributions.
* Issues: Please report bugs using the Issues section of GitHub
* Source Code Contributions:
* See [C# Coding Style](https://github.com/symbolspace/Symbol/wiki/C%23-Coding-Style) for reference on coding style.
## 静态扩展：Type判断
> *TypeExtensions*
### 判断是否为可为空类型，比如int?这种类型
> *public static bool IsNullableType(this Type type)*
> 返回为true表示此类型为struct类型，并且采用的是Nullable<T>。
```csharp
Console.WriteLine( typeof(bool).IsNullableType() );
Console.WriteLine( typeof(bool?).IsNullableType() );
Console.WriteLine( typeof(string).IsNullableType() );
/*
False
True
False
*/
```
### 获取可为空类型的原始类型
> *public static Type GetNullableType(this Type type)*
> 如果为非可为空类型，返回的就是它自己，反之而是被包装的类型。
```csharp
Console.WriteLine( typeof(bool).GetNullableType().FullName );
Console.WriteLine( typeof(bool?).GetNullableType().FullName );
Console.WriteLine( typeof(string).GetNullableType().FullName );
/*
System.Boolean
System.Boolean
System.String
*/
```
### 是否为匿名类型
> *public static bool IsAnonymousType(this object value)*
> *public static bool IsAnonymousType(this Type type)*
> 为null返回false，反之为匿名对象时返回true。
```csharp
var builder = new StringBuilder();
var info = new { name = "test" };
Console.WriteLine( builder.IsAnonymousType() );
Console.WriteLine( info.IsAnonymousType() );
Console.WriteLine( typeof(string).IsAnonymousType() );
/*
False
True
True
*/
```
### 是否为系统基础类型
> *public static bool IsSystemBaseType(this Type type)*
> 为true表示为基础类型，比如string int。
```csharp
Console.WriteLine( typeof(int).IsSystemBaseType() );
Console.WriteLine( typeof(Program).IsSystemBaseType() );
/*
True
False
*/
```
### 是否为数字类型
> *public static bool IsNumbericType(this Type type)*
> 为null时返回false，反之为数字类型时返回为true。
> 已知：byte,short,int,uint,long,ulong,float,decimal,double
> byte?,short?,int?,uint?,long?,ulong?,float?,decimal?,double?
```csharp
Console.WriteLine( typeof(int).IsNumbericType() );
Console.WriteLine( typeof(string).IsNumbericType() );
Console.WriteLine( "test".IsNumbericType() );
Console.WriteLine( (3.42F).IsNumbericType() );
/*
True
False
False
True
*/
```
### 判断两个类型是否有继承关系。
> *public static bool IsInheritFrom(this Type type, Type parent)*
> 支持接口、类，返回true表示有继承关系。
```csharp
interface IBase{ }
interface IFly : IBase { }
class Birds: IFly { }
class Pigeon : Birds { }
class Fish : IBase { }
static void Main()
{
Console.WriteLine( typeof(Pigeon).IsInheritFrom( typeof(Birds) ) );
Console.WriteLine( typeof(Pigeon).IsInheritFrom( typeof(IFly) ) );
Console.WriteLine( typeof(Pigeon).IsInheritFrom( typeof(IBase) ) );
Console.WriteLine( typeof(Fish).IsInheritFrom( typeof(IBase) ) );
Console.WriteLine( typeof(Fish).IsInheritFrom( typeof(Birds) ) );
Console.WriteLine( typeof(IFly).IsInheritFrom( typeof(IBase) ) );
}
/*
True
True
True
True
False
True
*/
```
## 静态扩展：值转换
> *ConvertExtensions*
### 强制转换为另一个类型（仅限struct类型）
> *public static T Convert(this object value, T defaultValue) where T : struct*
> 返回需要转换的类型，如果转换不成功时采用的默认值。
### 强制转换为另一个类型（泛型）
> *public static T Convert(this object value)*
> 返回需要转换的类型。
### 强制转换为另一个类型（非泛型）
> *public static object Convert(this object value, Type type)*
> 返回需要转换的类型，DBNull识别为null,支持数组转换。
### 调用示例：带默认值的用法
```csharp
int count = "3".Convert(0); //完整书写
int count1 = "3".Convert(0); //简写（推荐）
int count2 = "aa".Convert(-1);
Console.WriteLine(count);
Console.WriteLine(count1);
Console.WriteLine(count2);
/*
3
3
-1
*/
```
### 调用示例：常规转换
```csharp
string text = (1024).Convert();
string value = DBNull.Value.Convert();
int? age = "32".Convert();
int? age1 = "aaa".Convert();
Console.WriteLine(date);
Console.WriteLine(text);
Console.WriteLine(value);
Console.WriteLine(age);
Console.WriteLine(age1);
/*
1024
null
32
null
*/
```
### 调用示例：Boolean（布尔类型）
```csharp
Console.WriteLine( "true".Convert() );
Console.WriteLine( "ok".Convert() );
Console.WriteLine( "yes".Convert() );
Console.WriteLine( "good".Convert() );
Console.WriteLine( "t".Convert() );
Console.WriteLine( "True".Convert() );
Console.WriteLine( "TRUE".Convert() );
Console.WriteLine( "1".Convert() );
Console.WriteLine( 1.Convert() );
Console.WriteLine( "-1".Convert() );
Console.WriteLine( (-1).Convert() );
Console.WriteLine( "----" );
Console.WriteLine( "false".Convert() );
Console.WriteLine( "no".Convert() );
Console.WriteLine( "f".Convert() );
Console.WriteLine( "bad".Convert() );
Console.WriteLine( "not".Convert() );
Console.WriteLine( "False".Convert() );
Console.WriteLine( "FALSE".Convert() );
Console.WriteLine( "0".Convert() );
Console.WriteLine( 0.Convert() );
/*
True
True
True
True
True
True
True
True
True
True
True
----
False
False
False
False
False
False
False
False
False
*/
```
### 调用示例：Encoding
```csharp
Console.WriteLine( "utf-8".Convert().WebName );
Console.WriteLine( Encoding.UTF8.Convert() );
Console.WriteLine( (65001).Convert().CodePage );
Console.WriteLine( (65001L).Convert().CodePage );
Console.WriteLine( Encoding.UTF8.Convert() );
Console.WriteLine( Encoding.UTF8.Convert() );
Console.WriteLine( "xxxx".Convert() );
/*
utf-8
utf-8
65001
65001
65001
65001
null
*/
```
### 调用示例：Enum（枚举）
```csharp
Console.WriteLine( "ReadOnly, System".Convert() == (FileAttributes.ReadOnly | FileAttributes.System) );
Console.WriteLine( "readOnly,system".Convert() == (FileAttributes.ReadOnly | FileAttributes.System) );
Console.WriteLine( "readOnly, System".Convert() == FileAttributes.ReadOnly | FileAttributes.System );
Console.WriteLine( (5).Convert() == (FileAttributes.ReadOnly | FileAttributes.System) );
Console.WriteLine( "xxxx".Convert() );
Console.WriteLine( "----" );
Console.WriteLine( (FileAttributes.ReadOnly | FileAttributes.System).Convert() == "ReadOnly, System" );
Console.WriteLine( (FileAttributes.ReadOnly | FileAttributes.System).Convert() == 5 );
Console.WriteLine( (FileAttributes.ReadOnly | FileAttributes.System).Convert() == 5L );
/*
True
True
True
True
null
----
True
True
True
*/
```
### 调用示例：GUID
```csharp
Guid guid = new Guid("{B625052B-8D72-42CB-B71D-0AA5D116EB37}");
Console.WriteLine( "B625052B-8D72-42CB-B71D-0AA5D116EB37".Convert() == guid );
Console.WriteLine( "{B625052B-8D72-42CB-B71D-0AA5D116EB37}".Convert() == guid );
Console.WriteLine( guid.Convert() );
/*
True
True
b625052b-8d72-42cb-b71d-0aa5d116eb37
*/
```
### 调用示例：TimeSpan
```csharp
Console.WriteLine( "01:02:03".Convert() == new TimeSpan(01, 02, 03) );
Console.WriteLine( "01:02:03.033".Convert() == new TimeSpan(00, 01, 02, 03, 33) );
Console.WriteLine( "5.01:02:03.033".Convert() == new TimeSpan(05, 01, 02, 03, 33) );
Console.WriteLine( "----" );
Console.WriteLine( new TimeSpan(00, 01, 02, 03, 33).Convert() );
Console.WriteLine( new TimeSpan(00, 01, 02, 03).Convert() );
Console.WriteLine( new TimeSpan(05, 01, 02, 03, 33).Convert() );
Console.WriteLine( "----" );
Console.WriteLine( (1024).Convert() == new TimeSpan(1024) );
Console.WriteLine( (10240000L).Convert() == new TimeSpan(10240000L) );
Console.WriteLine( new TimeSpan(1024).Convert() == 1024 );
Console.WriteLine( new TimeSpan(10240000L).Convert() == 10240000L );
Console.WriteLine( "----" );
Console.WriteLine( (10240000D).Convert() == TimeSpan.FromMilliseconds(10240000D) );
Console.WriteLine( (10240000F).Convert() == TimeSpan.FromMilliseconds(10240000F) );
Console.WriteLine( (10240000M).Convert() == TimeSpan.FromMilliseconds((double)10240000M) );
Console.WriteLine( TimeSpan.FromMilliseconds(10240000D).Convert() == 10240000D );
Console.WriteLine( TimeSpan.FromMilliseconds(10240000F).Convert() == 10240000F );
Console.WriteLine( TimeSpan.FromMilliseconds((double)10240000M).Convert() == 10240000M );
Console.WriteLine( "----" );
Console.WriteLine( "test".Convert() );
Console.WriteLine( "99999.99:99:99.999999999999".Convert() );
Console.WriteLine( "----" );
/*
True
True
True
----
01:02:03.0330000
01:02:03
5.01:02:03.0330000
----
True
True
True
True
----
True
True
True
True
True
True
----
null
null
----
*/
```
### 调用示例：DateTime
```csharp
Console.WriteLine( "2007-12-20".Convert() == new DateTime(2007, 12, 20) );
int totalDays = (int)(new DateTime(2017, 02, 03) - DateTime.MinValue).TotalDays;
DateTime date = new DateTime(2017, 02, 03, 12, 30, 55, 99);
TimeSpan time = new TimeSpan(totalDays, 12, 30, 55, 99);
Console.WriteLine( date.Convert() == time );
Console.WriteLine( time.Convert() == date );
/*
True
True
True
*/
```
### 调用示例：Array
```csharp
static void PrintArray(T[] array)
{
for( int i =0; i < array.Length; i++ )
{
Console.WriteLine($"[{i}]{array[i]}");
}
Console.WriteLine("------------");
}
static void Main()
{
string[] array_source = new string[]
{
"1","1.5","3.2","999"
};
PrintArray( array_source.Convert() );
PrintArray( array_source.Convert() );
PrintArray( new List(array_source).Convert() );
PrintArray( array_source.GetEnumerator().Convert() );
}
/*
[0]1
[1]null
[2]null
[3]999
------------
[0]1
[1]1.5
[2]3.2
[3]999
------------
[0]1
[1]null
[2]null
[3]999
------------
[0]1
[1]1.5
[2]3.2
[3]999
------------
*/
```
### 调用示例：Structure（结构体）
```csharp
byte[] bytes = new byte[] { 5, 1, 0, 0 };
int number = 261;
int intValue = bytes.Convert(); //将二进制转换为结构体
Console.WriteLine( number == intValue );
byte[] intToBytes = number.Convert(); //将结构体转换为二进制数组
bool eq = true;
for( int i =0; i < intToBytes.Length; i++ )
{
if ( intToBytes[i] != bytes[i] )
{
eq = false;
break;
}
}
Console.WriteLine( eq );
/*
True
True
*/
```
### 调用示例：Implicit/Explicit（隐式/显式转换）
```csharp
class CustomString
{
public string? Value { get; set; }
public CustomString() {
Value = null;
}
public CustomString(string? value)
{
Value = value;
}
public override string? ToString()
{
return Value;
}
//显式转换：需要手动显式的转换，例如 int age = (int)32L; 显式将一个long转换为int。
public static explicit operator string?(CustomString customString)
{
return customString?.Value;
}
//隐式转换：在使用的时候无感，就如同 long value = 32 ;是隐式将int转换为了long
public static implicit operator CustomString(string? value)
{
return new CustomString(value);
}
//重写的目的只是为了方便测试：使两者相等。
public override bool Equals(object? obj)
{
if (obj == null)
return string.IsNullOrEmpty(Value);
if(obj is string)
return string.Equals(Value, (string)obj);
if(obj is CustomString customString)
return customString.Value == Value;
return base.Equals(obj);
}
}
static void Main()
{
CustomString customString = new CustomString("test");
string text = "test";
Console.WriteLine( text.Convert() == customString ); //触发：隐式转换
Console.WriteLine( customString.Convert() == text ); //触发：显式转换
}
/*
True
True
*/
```