Transformations 0.0.145

Transformations Type Converter

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.

Install-Package Transformations -Version 0.0.145
dotnet add package Transformations --version 0.0.145
<PackageReference Include="Transformations" Version="0.0.145" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Transformations --version 0.0.145
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

* 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);
// where Guid.Empty is the default value if the conversion fails.
// -----------------------------------------------
string valueInput = "0.1";
float actual = valueInput.ConvertTo<float>(0.0f);
// where 0.0f is the default value if the conversion fails.
// result = 0.1f;
// -----------------------------------------------
string valueInput = "15/02/2014";
DateTime actual = valueInput.ConvertTo<DateTime>(new DateTime(2000, 01, 01));
// where 2000-01-01 is the default value if the conversion fails.
// 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"))
{ ... }

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

.ToSqlParameter() extension methods make 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.

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


Added DataTable.HasRows()
// ie: dataTable != null && dataTable.Rows.Count > 0

Added DataRow.GetValue<T>()
- Gets the value as required type.

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

New:

Added Some Enum extensions, eg:

YourEnum.EnumElement.ToByte()
// gives an int enum for this enum

Same applies to
[...].ToDecimal()
[...].ToDouble()
[...].ToInt()
[...].ToLong()
etc.

Dependencies

This package has no dependencies.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
0.0.145 376 7/4/2017
0.0.144 268 5/19/2017
0.0.143 262 5/18/2017
0.0.142 280 5/16/2017
0.0.140 399 11/4/2016
0.0.139 275 11/4/2016
0.0.138 261 11/3/2016
0.0.137 263 11/3/2016
0.0.136 269 11/3/2016
0.0.135 286 11/2/2016
0.0.134 258 11/2/2016
0.0.133 264 11/2/2016
0.0.132 265 11/2/2016
0.0.131 281 11/2/2016
0.0.130 265 11/2/2016
0.0.129 424 12/14/2015
0.0.128 342 12/11/2015
0.0.127 309 12/10/2015
0.0.126 344 12/9/2015
0.0.125 331 11/20/2015
0.0.124 367 11/20/2015
0.0.123 293 11/20/2015
0.0.122 339 11/20/2015
0.0.121 296 11/20/2015
0.0.120 300 11/20/2015
0.0.119 316 11/17/2015
0.0.118 332 11/17/2015
0.0.117 307 11/17/2015
0.0.116 311 11/17/2015
0.0.115 297 11/17/2015
0.0.114 458 11/16/2015
0.0.113 284 11/16/2015
0.0.112 302 11/16/2015
0.0.111 328 11/12/2015
0.0.110 294 11/12/2015
0.0.109 321 11/3/2015
0.0.108 313 11/3/2015
0.0.107 312 11/3/2015
0.0.106 328 11/2/2015
0.0.105 297 11/2/2015
0.0.104 301 10/30/2015
0.0.103 303 10/30/2015
0.0.102 293 10/30/2015
0.0.101 307 10/30/2015
0.0.100 307 10/30/2015
0.0.99 321 10/23/2015
0.0.98 309 10/23/2015
0.0.97 315 10/19/2015
0.0.96 324 10/16/2015
0.0.95 337 10/16/2015
0.0.94 311 10/16/2015
0.0.93 304 10/16/2015
0.0.92 315 10/13/2015
0.0.91 330 10/13/2015
0.0.90 317 10/13/2015
0.0.89 350 9/16/2015
0.0.88 335 9/16/2015
0.0.87 335 8/20/2015
0.0.86 307 8/17/2015
0.0.85 300 8/6/2015
0.0.84 308 7/29/2015
0.0.83 302 7/29/2015
0.0.82 328 7/29/2015
0.0.81 303 7/28/2015
0.0.80 307 7/28/2015
0.0.79 303 7/27/2015
0.0.78 329 7/20/2015
0.0.77 391 7/20/2015
0.0.76 322 7/10/2015
0.0.75 303 7/10/2015
0.0.74 352 7/2/2015
0.0.73 326 7/2/2015
0.0.72 317 6/29/2015
0.0.71 308 6/29/2015
0.0.70 311 6/24/2015
0.0.69 324 6/23/2015
0.0.68 359 6/23/2015
0.0.67 311 6/22/2015
0.0.66 319 6/22/2015
0.0.65 333 6/5/2015
0.0.64 321 6/4/2015
0.0.63 314 6/4/2015
0.0.62 318 6/3/2015
0.0.61 325 6/2/2015
0.0.60 316 6/2/2015
0.0.59 366 6/1/2015
0.0.58 319 6/1/2015
0.0.57 377 6/1/2015
0.0.56 431 6/1/2015
0.0.55 317 5/29/2015
0.0.53 306 5/27/2015
0.0.52 304 5/27/2015
0.0.51 315 5/22/2015
0.0.50 310 5/21/2015
0.0.49 312 5/20/2015
0.0.48 313 5/20/2015
0.0.47 338 5/20/2015
0.0.46 320 5/20/2015
0.0.45 323 5/19/2015
0.0.44 320 5/19/2015
0.0.43 337 5/15/2015
0.0.42 309 5/14/2015
0.0.41 319 5/13/2015
0.0.40 331 5/12/2015
0.0.39 331 5/11/2015
0.0.38 332 5/7/2015
0.0.37 322 5/7/2015
0.0.36 313 5/7/2015
0.0.35 331 5/7/2015
0.0.34 312 5/7/2015
0.0.33 325 5/7/2015
0.0.32 319 5/6/2015
0.0.31 297 5/6/2015
0.0.30 305 5/6/2015
0.0.29 312 5/6/2015
0.0.28 310 5/6/2015
0.0.27 309 5/5/2015
0.0.26 314 5/5/2015
0.0.25 306 4/27/2015
0.0.24 327 4/24/2015
0.0.23 370 4/23/2015
0.0.22 365 4/2/2015
0.0.21 306 4/2/2015
0.0.20 318 4/1/2015
0.0.19 319 3/31/2015
0.0.18 341 3/31/2015
0.0.17 349 3/31/2015
0.0.16 322 3/31/2015
0.0.15 297 3/31/2015
0.0.14 327 3/31/2015
0.0.13 301 3/31/2015
0.0.12 309 3/30/2015
0.0.11 311 3/30/2015
0.0.10 324 3/30/2015