D365Extensions 1.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package D365Extensions --version 1.3.0
NuGet\Install-Package D365Extensions -Version 1.3.0
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="D365Extensions" Version="1.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add D365Extensions --version 1.3.0
#r "nuget: D365Extensions, 1.3.0"
#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 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

NuGet version (D365Extensions) Build Status Conventional Commits

D365Extensions

A collection of Extension methods for Microsoft Dynamics CRM/D365 SDK base classes

Setup

All extension methods are declared in the same namespace as related SDK types. No additional using statements required.

Usage

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.Lib.MSBuild.Task

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 !!!

What's new

Semantic Versioning is used since v1.1.0. For version history please refer to CHANGELOG.md

Extensions

Entity Extensions

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.

IOrganizationService Extensions

Set of extension methods for IOrganizationService base class. Basically these are simple overrides of existing methods which take EntityReference or Entity instead of separate Id and LogicalName parameters.

IPluginExecutionContext Extensions

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.

CodeActivityContext Extensions

Set of extension methods for System.Activities.CodeActivityContext base class. Short cut methods for getting D365 related services from workflow execution context.

IServiceProvider Extensions

Set of extension methods for Microsoft.Xrm.Sdk.IServiceProvider base class. Just shortcut methods to save you few lines of code during plugin development.

EntityReference Extensions

Set of extension methods for Microsoft.Xrm.Sdk.EntityReference base class. At the moment just two simple but sometimes useful type conversion methods.

Query Extensions

Set of extension methods for Microsoft.Xrm.Sdk.QueryBase and derived classes. At the moment only paging improvements.

Contributing

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
Product Compatible and additional computed target framework versions.
.NET Framework net452 is compatible.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
2.1.0 257 5/30/2023
2.0.0 141 5/1/2023
1.5.3 1,530 12/2/2022
1.4.1 8,355 4/15/2022
1.4.0 463 2/7/2022
1.3.0 370 10/15/2021
1.2.1 937 8/19/2020
1.2.0 520 7/19/2020
1.1.0 11,461 8/30/2019
1.0.43 668 7/9/2019
1.0.42 646 6/28/2019
1.0.38 688 6/3/2019
1.0.37 638 5/27/2019
1.0.36 714 4/22/2019
1.0.35 652 4/15/2019
1.0.32 649 3/21/2019
1.0.31 645 3/11/2019
1.0.30 639 3/10/2019
1.0.28 747 2/4/2019
1.0.22 710 1/31/2019
1.0.21 778 12/19/2018
1.0.17 711 12/19/2018
1.0.16 841 10/5/2018
1.0.15 810 10/2/2018
1.0.8 833 10/1/2018
1.0.6 807 9/30/2018