Install-Package D365Extensions -Version 1.3.0
dotnet add package D365Extensions --version 1.3.0
<PackageReference Include="D365Extensions" Version="1.3.0" />
paket add D365Extensions --version 1.3.0
#r "nuget: D365Extensions, 1.3.0"
// Install D365Extensions as a Cake Addin #addin nuget:?package=D365Extensions&version=1.3.0 // Install D365Extensions as a Cake Tool #tool nuget:?package=D365Extensions&version=1.3.0
A collection of Extension methods for Microsoft Dynamics CRM/D365 SDK base classes
All extension methods are declared in the same namespace as related SDK types. No additional
using statements required.
This assembly is assumed to be used for plugin development. As D365 for CE currently doesn't support assembly dependencies you have to merge it in your primary plugin assembly. We recommend using this tool:
ILRepack use the same technique as ILMerge but it is build on newer versions of Mono instruments so it is more fast and efficient. Please refer to link above for documentation.
To configure this task your should add
ILRepack.targets file to you project. File contents should be looking like the following:
<?xml version="1.0" encoding="utf-8" ?> <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <Target Name="AfterBuild" Condition="'$(BuildingForLiveUnitTesting)' != 'true'"> <ItemGroup> <InputAssemblies Include="$(OutputPath)\$(AssemblyName).dll" /> <InputAssemblies Include="$(OutputPath)\D365Extensions.dll" /> </ItemGroup> <ILRepack Parallel="true" DebugInfo="true" InputAssemblies="@(InputAssemblies)" LibraryPath="$(OutputPath)" KeyFile="$(AssemblyOriginatorKeyFile)" OutputFile="$(OutputPath)\$(AssemblyName).dll" /> </Target> </Project>
You should use
KeyFile parameter as your plugin assembly should be signed. We also recommend use
LibraryPath parameter as shown to avoid merge problems with dependent SDK assemblies.
!!! Never merge SDK assemblies in your code. It will cause runtime errors !!!
Set of extension methods for Microsoft.Xrm.Sdk.Entity base class. Simplifies dealing with Aliased and Formated values as well as working with Attributes collection.
Set of extension methods for IOrganizationService base class. Basically these are simple overrides of existing methods which take EntityReference or Entity instead of separate
Set of extension methods for Microsoft.Xrm.Sdk.IPluginExecutionContext base class. Most of this helpers are shortcuts for existing properties but provides additional checks or type casts. Unlike Entity class extensions most of the following extensions are not exception safe! It is done so because you most likely want to get an error if plugin is registered for a wrong message or you have a typo in parameter name.
Set of extension methods for System.Activities.CodeActivityContext base class. Short cut methods for getting D365 related services from workflow execution context.
Set of extension methods for Microsoft.Xrm.Sdk.IServiceProvider base class. Just shortcut methods to save you few lines of code during plugin development.
Set of extension methods for Microsoft.Xrm.Sdk.EntityReference base class. At the moment just two simple but sometimes useful type conversion methods.
Set of extension methods for Microsoft.Xrm.Sdk.QueryBase and derived classes. At the moment only paging improvements.
Please fill free to create issue if you find a bug or have an idea. PR's are welcomed as well! 😃 Help wanted in the following areas:
- Unit tests. Most of extensions are just wrappers/overrides of SDK classes but as list of extension grows method call chain grows as well. It seems like it's a time to unit check all methods
- Code documentation. As it turns out XML code documentation and wiki documentation are very different. Help with updating code doc is appreciated
This package is not used by any NuGet packages.
This package is not used by any popular GitHub repositories.