Transformations 0.0.33

There is a newer version of this package available.
See the version list below for details.
dotnet add package Transformations --version 0.0.33
NuGet\Install-Package Transformations -Version 0.0.33
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Transformations" Version="0.0.33" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Transformations --version 0.0.33
#r "nuget: Transformations, 0.0.33"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Transformations as a Cake Addin
#addin nuget:?package=Transformations&version=0.0.33

// Install Transformations as a Cake Tool
#tool nuget:?package=Transformations&version=0.0.33

Conversion between data types. Envisaged as a possible alternative to the Universal Type Converter http://www.codeproject.com/Articles/248440/Universal-Type-Converter, with the provision for default values, and some extra features.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 275 4/17/2023
1.0.0 717 3/25/2020
0.0.145 2,687 7/4/2017
0.0.144 2,470 5/19/2017
0.0.143 2,404 5/18/2017
0.0.142 2,443 5/16/2017
0.0.140 2,896 11/4/2016
0.0.139 2,736 11/4/2016
0.0.138 2,685 11/3/2016
0.0.137 2,674 11/3/2016
0.0.136 2,718 11/3/2016
0.0.135 2,683 11/2/2016
0.0.134 2,640 11/2/2016
0.0.133 2,667 11/2/2016
0.0.132 2,671 11/2/2016
0.0.131 2,728 11/2/2016
0.0.130 2,571 11/2/2016
0.0.129 2,591 12/14/2015
0.0.128 2,552 12/11/2015
0.0.127 2,501 12/10/2015
0.0.126 2,619 12/9/2015
0.0.125 2,538 11/20/2015
0.0.124 2,521 11/20/2015
0.0.123 2,533 11/20/2015
0.0.122 2,548 11/20/2015
0.0.121 2,525 11/20/2015
0.0.120 2,552 11/20/2015
0.0.119 2,543 11/17/2015
0.0.118 2,584 11/17/2015
0.0.117 2,572 11/17/2015
0.0.116 2,555 11/17/2015
0.0.115 2,523 11/17/2015
0.0.114 2,858 11/16/2015
0.0.113 2,493 11/16/2015
0.0.112 2,674 11/16/2015
0.0.111 2,536 11/12/2015
0.0.110 2,465 11/12/2015
0.0.109 2,464 11/3/2015
0.0.108 2,477 11/3/2015
0.0.107 2,515 11/3/2015
0.0.106 2,529 11/2/2015
0.0.105 2,491 11/2/2015
0.0.104 2,474 10/30/2015
0.0.103 2,500 10/30/2015
0.0.102 2,500 10/30/2015
0.0.101 2,476 10/30/2015
0.0.100 2,482 10/30/2015
0.0.99 2,462 10/23/2015
0.0.98 2,487 10/23/2015
0.0.97 2,492 10/19/2015
0.0.96 2,490 10/16/2015
0.0.95 2,547 10/16/2015
0.0.94 2,456 10/16/2015
0.0.93 2,482 10/16/2015
0.0.92 2,484 10/13/2015
0.0.91 2,507 10/13/2015
0.0.90 2,494 10/13/2015
0.0.89 2,572 9/16/2015
0.0.88 2,533 9/16/2015
0.0.87 2,554 8/20/2015
0.0.86 2,471 8/17/2015
0.0.85 2,819 8/6/2015
0.0.84 2,654 7/29/2015
0.0.83 2,657 7/29/2015
0.0.82 2,677 7/29/2015
0.0.81 2,632 7/28/2015
0.0.80 2,643 7/28/2015
0.0.79 2,606 7/27/2015
0.0.78 2,608 7/20/2015
0.0.77 2,653 7/20/2015
0.0.76 2,533 7/10/2015
0.0.75 2,509 7/10/2015
0.0.74 2,541 7/2/2015
0.0.73 2,538 7/2/2015
0.0.72 2,515 6/29/2015
0.0.71 2,482 6/29/2015
0.0.70 2,487 6/24/2015
0.0.69 2,519 6/23/2015
0.0.68 2,547 6/23/2015
0.0.67 2,532 6/22/2015
0.0.66 2,532 6/22/2015
0.0.65 2,503 6/5/2015
0.0.64 2,532 6/4/2015
0.0.63 2,507 6/4/2015
0.0.62 2,517 6/3/2015
0.0.61 2,554 6/2/2015
0.0.60 2,490 6/2/2015
0.0.59 2,643 6/1/2015
0.0.58 2,473 6/1/2015
0.0.57 2,671 6/1/2015
0.0.56 2,866 6/1/2015
0.0.55 2,471 5/29/2015
0.0.53 2,496 5/27/2015
0.0.52 2,482 5/27/2015
0.0.51 2,514 5/22/2015
0.0.50 2,484 5/21/2015
0.0.49 2,511 5/20/2015
0.0.48 2,499 5/20/2015
0.0.47 2,535 5/20/2015
0.0.46 2,513 5/20/2015
0.0.45 2,524 5/19/2015
0.0.44 2,510 5/19/2015
0.0.43 2,500 5/15/2015
0.0.42 2,465 5/14/2015
0.0.41 2,480 5/13/2015
0.0.40 2,499 5/12/2015
0.0.39 2,507 5/11/2015
0.0.38 2,516 5/7/2015
0.0.37 2,482 5/7/2015
0.0.36 2,471 5/7/2015
0.0.35 2,482 5/7/2015
0.0.34 2,465 5/7/2015
0.0.33 2,582 5/7/2015
0.0.32 2,502 5/6/2015
0.0.31 2,594 5/6/2015
0.0.30 2,506 5/6/2015
0.0.29 2,500 5/6/2015
0.0.28 2,595 5/6/2015
0.0.27 2,600 5/5/2015
0.0.26 2,504 5/5/2015
0.0.25 2,623 4/27/2015
0.0.24 2,635 4/24/2015
0.0.23 2,911 4/23/2015
0.0.22 2,733 4/2/2015
0.0.21 2,514 4/2/2015
0.0.20 2,526 4/1/2015
0.0.19 2,520 3/31/2015
0.0.18 2,587 3/31/2015
0.0.17 2,555 3/31/2015
0.0.16 2,528 3/31/2015
0.0.15 2,483 3/31/2015
0.0.14 2,537 3/31/2015
0.0.13 2,509 3/31/2015
0.0.12 2,487 3/30/2015
0.0.11 2,513 3/30/2015
0.0.10 2,516 3/30/2015

* You don't need to reference the transformations namespace with Using statement (type conversions are meant to be universal if you choose to use this).

Generally you would just do:

 var newValue = oldValue.ConvertTo<newType>(optionalDefaultValue);

* You can use TryConvertTo if you need to get the result of the conversion process.

* You can do some conversions on DataTables and Lists , for example convert a data table to an object list, if the names of the columns match the object properties.

* The date conversion is set to British date format by default, not the project's current format. This may have to change to make the library more "universal".

* From some basic tests I have performed on universal type converter and this library, I found it to be a bit faster than the universal type converter...

********************************************
Some examples of use:
********************************************
string valueInput = "7F8C14B6-B3A8-4F71-8EFC-E5A7B35923B6";
Guid actual = valueInput.ConvertTo<Guid>(Guid.Empty);
// -----------------------------------------------
string valueInput = "0.1";
float actual = valueInput.ConvertTo<float>(0.0f);
// result = 0.1f;
// -----------------------------------------------
string valueInput = "15/02/2014";
DateTime actual = valueInput.ConvertTo<DateTime>(new DateTime(2000, 01, 01));
// result = new DateTime(2014, 02, 15);
// -----------------------------------------------
float? f = 123.524f;
int? i = f.ConvertTo<int>();
// result = 124;
// -----------------------------------------------

* You can convert date to 'excel'-type value:
DateTime d = new DateTime(2005, 5, 5);
d.ToDouble();
// or d.ToInt();

List conversions examples:
// -----------------------------------------------
List<int> l1 = new List<int>(new int[] { 2, 3, 4 });
List<float> l2 = l1.ConvertToList<int, float>();
// -----------------------------------------------



**************************************************

Some additional helper methods are added as extensions as well:

// -----------------------------------------------

*Proper Case*

string name = "mr john smith";
name.ProperCase();
// result = "Mr John Smith";

// -----------------------------------------------

*Insert Spaces*

string name = "MrJohnSmith";
name.InsertSpaces();
// result = "Mr John Smith";

// -----------------------------------------------

*Remove Chars* - removes multiple instances of the same string pattern from the string.

string name = "Mr John John Smith";
name.RemoveChars("John ");
// result = "Mr Smith";

// -----------------------------------------------

*Replace Ex* - replace multiple instances of the same string pattern in the string.
string s = "12345678901234567890";
s.ReplaceEx("2", "X");
// result = "1X345678901X34567890";

// -----------------------------------------------

*Is Date* - check if string is a date! assumes en-Gb as default culture at present..

string s = "14/02/2014";
if (IsDate(s))
{ ... }
if (IsDate(s, "en-GB"))
{ ... }

// -----------------------------------------------

New in version 22: I have recently added .ToSqlParameter() extension methods.

It makes it easier to effectively make the swift conversion to SqlParameters from most types, but please always check that the correct SqlDbType is supplied...

For example, if you wanted to supply myChar parameter to a stored procedure - a char conversion could be:

char c = 'a';
c.ToSqlParameter('myChar');
- and you would probably want to add SqlParameter to the list of parameters.

When converting a string to a varchar / nvarchar, a size of the string is required. It's usually the best practice to supply the string size to avoid runtime errors.

I'm thinking of adding a completely separate validation method to SqlParameter list, which will test that each conversion can be performed correctly.