ZayniFramework.Common 2.1.0

Add namespace using in your code.

using ZayniFramework.Common;

Extensions API example.

DateTimeExtension

Test a DateTime range. Use the DateTime.IsBetween() extension method.

var dt    = new DateTime( 2013, 12, 24 );
var begin = new DateTime( 2013, 12, 1 );
var end   = new DateTime( 2013, 12, 31 );
Assert.IsTrue( dt.IsBetween( begin, end ) );
Assert.IsFalse( dt.IsBetween( new DateTime( 2013, 12, 28 ), end ) );

Convert DateTime to a UNIX UTC timestamp. Use the DateTime.ToUnixUtcTimestamp() extension method.

long timestamp = DateTime.Now.ToUnixUtcTimestamp( withMilliseconds: true );

ObjectExtension

Convert an object to a Dictionary. Use the Object.ConvertToDictionary() extension method.

public void ConvertToDictionary_Example()
{
    var model = new UserModel
    {
        Name = "Amber",
        Age  = 23,
        Sex  = "female"
    };

    IDictionary dict = model.ConvertToDictionary();

    string name = dict[ "Name" ] + "";
    string sex  = dict[ "Sex" ]  + "";
    int    age  = int.Parse( dict[ "Age" ] + "" );
}

Convert List<T> to DataTable. Use List<T>.ConvertToDataTable() extension method.

var list = new List<UserModel>() 
{
    new UserModel() 
    {
        Name = "Sylvia",
        Age  = 35,
        Sex  = "Female"
    },
    new UserModel() 
    {
        Name = "Kate",
        Age  = 20,
        Sex  = "Female"
    },
    new UserModel() 
    {
        Name = "John",
        Age  = 23,
        Sex  = "Male"
    }
};

DataTable dt = list.ConvertToDataTable( "SomeTableName" );
Assert.IsNotNull( dt );          

Distinct by conditions. Use IEnumerable<T>.Distinct( Func<TSource, TKey> selector ) extension method.

List<UserModel> models = MakeFakeUsers();
IEnumerable<UserModel> results = models.Distinct( k => new { Name = k.Name, Age = k.Age } );

Deep Clone Object. Use Object.CloneObject() or Object.Clone() extension method.

UserModel clone = obj.CloneObject<UserModel>();
UserModel copy  = obj.Clone<UserModel>();

Invoke the object's method. Use the Object.MethodInvoke() extension method.

public class MemberModel
{
    public string Name { get; set; }

    public string SayHello( string message ) => $"Hello, my name is {Name}. {message}";
}

public void MethodInvoke_Example()
{
    var model  = new MemberModel() { Name = "Sylvia" };
    var result = model.MethodInvoke( "SayHello", "This is a test." );
    Assert.AreEqual( "Hello, my name is Sylvia. This is a test.", result );
}

Get the property value. Use the Object.GetPropertyValue() extension method.

public void GetPropertyValueTest()
{
    var model = new MemberModel()
    {
        Name = "Kate"
    };

    object obj = model.GetPropertyValue( "Name" );
    Assert.IsNotNull( obj );

    string name = obj + "";
    Assert.AreEqual( model.Name, name );

    name = model.GetPropertyValue<string>( "Name" );
    Assert.AreEqual( model.Name, name );
}

StringExtension

Convert a string to byte array. Use the String.ToBytes() extension method. Also demo how to use IEnumerable.IsNotNullAndEmptyArray() entension method.

public void ToBytes_Example()
{
    string test   = "This is a test string.";
    byte[] binary = test.ToBytes();
    Assert.IsTrue( binary.IsNotNullAndEmptyArray() );

    string result = System.Text.Encoding.UTF8.GetString( binary );
    Assert.AreEqual( test, result );
}

Remove the first appeared from a string. Use String.RemoveFirstAppeared() extension method.

string source = "AAABBBCCCAAA";
string result = source.RemoveFirstAppeared( "AAA" );
Assert.AreEqual( "BBBCCCAAA", result );

Remove the last appeared from a string. Use String.RemoveLastAppeared() extension method.

string source = "AAABBBCCCAAACCC";
string result = source.RemoveLastAppeared( "CCC" );
Assert.AreEqual( "AAABBBCCCAAA", result );

Test a string is null or an empty string. Demo the String.IsNullOrEmpty(), String.IsNotNullOrEmpty(), String.FormatTo() extension method.

public void StringIsNullOrEmpty_Example()
{
    string test1 = "";
    Assert.IsTrue( test1.IsNullOrEmpty() );
    Assert.IsFalse( test1.IsNotNullOrEmpty() );

    string test2 = null;
    Assert.IsTrue( test2.IsNullOrEmpty() );
    Assert.IsFalse( test2.IsNotNullOrEmpty() );

    string test3 = "kkk";
    Assert.IsFalse( test3.IsNullOrEmpty() );
    Assert.IsTrue( test3.IsNotNullOrEmpty() );

    string expected1 = "Hello my name is Sylvia. I love Pony.";
    string expected2 = "I'm Pony. Sylvia is my lover.";

    string test4  = "Hello my name is {0}. I love {1}.";
    string result = test4.FormatTo( "Sylvia", "Pony" );
    Assert.AreEqual( expected1, result );

    string result2 = "I'm {0}. {1} is my lover.".FormatTo( "Pony", "Sylvia" );
    Assert.AreEqual( expected2, result2 );
}

Dynamic API example.

Add using.

using ZayniFramework.Common;
using ZayniFramework.Common.Dynamic;

Bind a property to dynamic object in runtime.

Use DynamicBroker.CreateDynamicObject() and DynamicBroker.BindProperty() static method.

public void BindPropertyTest()
{
    dynamic obj = DynamicBroker.CreateDynamicObject();
    Assert.IsNotNull( obj );

    bool isOk = DynamicBroker.BindProperty( obj, "UserName", "Sylvia" ); 
    Assert.IsTrue( isOk );

    string name = obj.UserName;
    Assert.AreEqual( "Sylvia", name );

    bool isOk2 = DynamicBroker.BindProperty( obj, "UserName", "Vivian" );
    Assert.IsTrue( isOk2 );

    string name2 = obj.UserName;
    Assert.AreEqual( "Vivian", name2 );
}

Bind a delegate to dynamic object in runtime.

Use DynamicBroker.BindMethod() static method. Also demo Object.IsNotNull() extension method.

public void BindMethod_Example() 
{
    dynamic obj = DynamicBroker.CreateDynamicObject();
    Assert.IsNotNull( obj );

    bool isOk = DynamicBroker.BindProperty( obj, "UserName", "Sylvia" );
    Assert.IsTrue( isOk );

    string name = obj.UserName;
    Assert.AreEqual( "Sylvia", name );

    SaySomething handler = ( m ) => {
        return string.Format( "Hi, my name is {0}. {1}", obj.UserName, m );
    };

    bool isOk2 = DynamicBroker.BindMethod<SaySomething>( obj, "IntroduceYourself", handler );
    Assert.IsTrue( isOk2 );

    string message = obj.IntroduceYourself( "Nice to meet you." );
    Assert.IsTrue( message.IsNotNullOrEmpty() );
    Assert.AreEqual( "Hi, my name is Sylvia. Nice to meet you.", message );
}

TaskQueue example.

Add using.

using ZayniFramework.Common;
using ZayniFramework.Common.Tasks;

EnQueue an action to TaskQueue.

private static void ExecuteDirectly()
{
    var queue = new TaskQueue( false );

    for ( int i = 0; i < 50; i++ )
    {
        int j = i + 1;

        dynamic queueAction = new QueueAction( new Work().DoSomething );
        queueAction.Index   = j;
        queueAction.Message = new { Test = "123", NumberNo = 55 };
        queue.EnQueue( queueAction );
    }
}

More TaskQueue detail sample here.