From DotNetHelpers (sources)

This folder contains source files of $Data and $ORM code packages (database support + simple ORM),
which are (usually) compiled into “CommonHelpers.3.dll”.
To see other source packages, investigate original source folders of DotNetHelpers-library
(if available): “HandicraftSDK\DotNetHelpers\CommonHelpers.*”.
However, MyFlat app. is here a standalone sample. This means, it is compiled here independently from
DotNetHelpers library sources. Instead, it relies on its previously-built DLLs, located in following
folder: “Extralight-ORM test sample (En+Ru)\MyFlat app. (MVC+Razor+TS+ADO+TSQL)\AssemblyRef”
(“CommonHelpers.dll”, “CommonHelpers.2.dll” and “CommonHelpers.3.dll”).
/*
To build the sample with reference to original DotNetHelpers location (AssemblyRef subfolder),
the project has to be modified in the following way (see below):
*/
----------------------------------------------------------------------------------------------------
___ “MyFlat.Base.csproj” ___:
# from
[[
<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk">
: : : : :
  <ItemGroup>
: : : : :
    <Reference Include="CommonHelpers">
      <HintPath>..\AssemblyRef\CommonHelpers.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="CommonHelpers.3">
      <HintPath>..\AssemblyRef\CommonHelpers.3.dll</HintPath>
      <Private>false</Private>
    </Reference>
: : : : :
  </ItemGroup>
: : : : :
</Project>
]]
# to
[[
<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk">
: : : : :
  <ItemGroup>
: : : : :
    <Reference Include="CommonHelpers">
      <HintPath>$(HandicraftSDK_Root)\DotNetHelpers\.WIN32\AssemblyRef\CommonHelpers.dll</HintPath>
      <!--<HintPath>..\..\..\..\DotNetHelpers\.WIN32\AssemblyRef\CommonHelpers.dll</HintPath>-->
      <Private>false</Private>
    </Reference>
    <Reference Include="CommonHelpers.3">
      <HintPath>$(HandicraftSDK_Root)\DotNetHelpers\.WIN32\AssemblyRef\CommonHelpers.3.dll</HintPath>
      <!--<HintPath>..\..\..\..\DotNetHelpers\.WIN32\AssemblyRef\CommonHelpers.3.dll</HintPath>-->
      <Private>false</Private>
    </Reference>
: : : : :
  </ItemGroup>
: : : : :
</Project>
]]
----------------------------------------------------------------------------------------------------
___ “MyFlat.csproj” ___:
# from
[[
<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk.Web">
: : : : :
  <ItemGroup>
: : : : :
    <Reference Include="CommonHelpers">
      <HintPath>..\AssemblyRef\CommonHelpers.dll</HintPath>
      <Private>true</Private>
    </Reference>
    <Reference Include="CommonHelpers.2">
      <HintPath>..\AssemblyRef\CommonHelpers.2.dll</HintPath>
      <Private>true</Private>
    </Reference>
    <Reference Include="CommonHelpers.3">
      <HintPath>..\AssemblyRef\CommonHelpers.3.dll</HintPath>
      <Private>true</Private>
    </Reference>
: : : : :
  </ItemGroup>
: : : : :
</Project>
]]
# to
[[
<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk.Web">
: : : : :
  <ItemGroup>
: : : : :
    <Reference Include="CommonHelpers">
      <HintPath>$(HandicraftSDK_Root)\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.dll</HintPath>
      <!--<HintPath>..\..\..\..\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.dll</HintPath>-->
      <Private>true</Private>
    </Reference>
    <Reference Include="CommonHelpers.2">
      <HintPath>$(HandicraftSDK_Root)\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.2.dll</HintPath>
      <!--<HintPath>..\..\..\..\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.2.dll</HintPath>-->
      <Private>true</Private>
    </Reference>
    <Reference Include="CommonHelpers.3">
      <HintPath>$(HandicraftSDK_Root)\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.3.dll</HintPath>
      <!--<HintPath>..\..\..\..\DotNetHelpers\Libraries\.WIN32\AssemblyRef\CommonHelpers.3.dll</HintPath>-->
      <Private>true</Private>
    </Reference>
: : : : :
  </ItemGroup>
: : : : :
</Project>
]]
----------------------------------------------------------------------------------------------------
(“MyFlat.Base.csproj.props”-file, probably, should be corrected.)
Also, DotNetHelpers library compilation requires cryptography key XSoft, installed into container
under user profile.
For test key installation from PFX, go to:
“HandicraftSDK\Miscellaneous\Demo and samples (misc.)\XSoft crypto\XSoft certificate”
/*
> install_csp_container.cmd
> uninstall_csp_container.cmd
> XSoft.pfx
> XSoft.pfx.password.txt
> DNH_KeyContainerName=XSoft
Assign persistent environment variable (e.g.):
> setx /m DNH_KeyContainerName "XSoft"
*/
Above mentioned is needed only for DotNetHelpers library re-compilation.
Its allready-compiled assemblies are normally located by following paths:
1) “HandicraftSDK\DotNetHelpers\Libraries\.NETFULL\AssemblyRef” (.net 4.5+);
2) “HandicraftSDK\DotNetHelpers\Libraries\.WIN32\AssemblyRef” (Win32; netstandard2.1);
3) “HandicraftSDK\DotNetHelpers\Libraries\AssemblyRef” (netstandard2.1).
----------------------------------------------------------------------------------------------------
