Crm.Sdk.Core 11.0.1

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. 
dotnet add package Crm.Sdk.Core --version 11.0.1
                    


                    

                
NuGet\Install-Package Crm.Sdk.Core -Version 11.0.1
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="Crm.Sdk.Core" Version="11.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Crm.Sdk.Core" Version="11.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Crm.Sdk.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Crm.Sdk.Core --version 11.0.1
                    


                    

                
#r "nuget: Crm.Sdk.Core, 11.0.1"
#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. 
#:package Crm.Sdk.Core@11.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Crm.Sdk.Core&version=11.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Crm.Sdk.Core&version=11.0.1
                    


                            Install as a Cake Tool

Crm.Sdk.Core.Async

Logo of the project

Async SDK for Microsoft Dynamics CRM on-premises, including CRM 2015.

NuGet

Install

dotnet add package Crm.Sdk.Core --version 11.0.1

The 11.0.1 release is prepared in this repository; the package owner publishes it to NuGet separately. Until then, use the generated nupkg from a local feed. ADFS, Live ID and Dynamics 365 Online authentication are not implemented.

Lite alternative

Crm.Sdk.Core.Async.Lite (package DevelKit.Crm.Sdk.Lite) uses direct SOAP-over-HTTP while keeping familiar SDK namespaces and class names, including Microsoft.Xrm.Sdk.Entity and Microsoft.Xrm.Sdk.Client.OrganizationServiceProxy. Its main benefit is fewer dependencies and no WCF channel infrastructure, not guaranteed faster CRM calls.

This Full package (Crm.Sdk.Core) already includes a similar direct SOAP-over-HTTP implementation: Microsoft.Xrm.Sdk.OData.OrganizationDataWebServiceProxy. You can use it without switching to Lite, but it uses separate types in the Microsoft.Xrm.Sdk.OData namespace and the Full package still includes WCF dependencies.

The Microsoft.Xrm.Sdk.OData assembly may be removed from Full in a future release, with the direct HTTP implementation maintained only in Lite. This is a possible direction, not an announced removal; no removal version or date has been set.

Use one package variant per application: their assembly names overlap.

Framework compatibility

Consumer Selected package assets
.NET Core 2.1, 2.2, 3.0, 3.1 and .NET 5 netstandard2.0
.NET 6, 7, 8, 9, 10 matching net6.0 through net10.0

Build with the .NET 10 SDK. Older target compatibility does not imply that those runtimes still receive security updates from Microsoft. Regression suites target .NET 6, 8, 9 and 10. Package smoke tests (serialization, two pooled SOAP calls, and cancellation isolation) also passed on Windows with runtimes 2.1.30, 2.2.8, 3.0.3, 3.1.32, 5.0.17 and 7.0.20. This is local protocol validation, not a live CRM compatibility certification.

NTLM and connection lifetime

NTLM/Negotiate authentication is performed by HttpClientHandler so the transport keeps the handshake on one connection and reuses authenticated sockets. The old manual handshake and its hidden HttpClient timeout have been removed. Credentials are restricted to NTLM/Negotiate on the first CRM authority; redirects are not followed. Configure credentials and proxy settings before the first call.

Windows uses SSPI. Linux needs a working GSSAPI NTLM provider (for example the OS package gss-ntlmssp); validate the target container with your domain. A managed NTLM fallback is no longer provided. Never disable TLS validation to make a connection work; install the organization's trusted CA certificates instead.

Keep each proxy alive for its owner's lifetime and dispose it when that owner stops. Lite/OData keep a handler per proxy; per-call HttpClient wrappers do not destroy its connection pool. Do not use a WCF proxy concurrently: lease it to one operation at a time. Do not mutate a NetworkCredential while it is in use.

Cancellation, timeouts and writes

Cancellation is local. CRM 2015 does not accept a .NET CancellationToken as part of its SOAP contract. Canceling or timing out a client does not confirm that CRM rolled back a write. After dispatch, a lost response means the outcome can be unknown; reconcile the result before repeating a create.

The Full proxy Timeout maps to WCF binding timeouts and channel OperationTimeout. Lite/OData use the per-call HttpClient timeout. Registration of local cancellation is scoped to one call and cannot abort a later pooled call. Write operations and generic Execute are not automatically replayed by the Full proxy after errors.

CRM's standard duplicate detection can be requested with CreateRequest and SuppressDuplicateDetection=false. It requires enabled, published server rules and is not an atomic uniqueness guarantee for concurrent creates.

Version 11 compatibility

Version 11.0.1 restores the established public configuration and proxy API. Use IOrganizationService as before:

var configuration = ServiceConfigurationFactory
    .CreateConfiguration<IOrganizationService>(organizationServiceUri);
using var service = new OrganizationServiceProxy(configuration, credentials);

CancellationToken remains a local method argument. The SDK excludes it from the WCF message description internally, so it is never serialized into CRM's SOAP body. No separate public wire-contract interface is required. If you adopted the temporary IOrganizationServiceContract API in 11.0.0, change those references back to IOrganizationService when upgrading to 11.0.1. The Full package includes the WCF SDK, message assemblies and OData client.

Build and verify

./build.ps1

Install .NET runtimes 6, 8, 9 and 10 to execute the test matrix. The script builds all target assets, runs the isolated loopback tests, compiles package consumers for .NET Core 2.1, 2.2, 3.0, 3.1 and .NET 5-10, and puts the nupkg in artifacts/. Use -SkipTests only if test execution is handled separately. To repeat runtime smoke tests with isolated Windows runtimes, run ./verify-runtimes.ps1 -RuntimeRoot <directory>; the directory contains 2.1/, 2.2/, 3.0/, 3.1/, 5.0/ and 7.0/ dotnet installations.

Tests never connect to a live CRM. The NTLM handshake test uses a native server challenge on .NET 8+ and checks connection affinity and request count; it is not a domain-credential validation test.

License

MIT. See LICENSE.md.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos 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
11.0.1 93 9/18/2026
10.3.0 9,407 5/30/2023
10.2.6 317 5/30/2023
10.2.5 301 5/30/2023
6.1.5 834 4/11/2023
6.1.4 388 4/5/2023
6.1.2 391 4/4/2023
6.1.1 399 4/4/2023
6.1.0 368 4/4/2023
6.0.10 398 3/22/2023
3.0.10 3,175 5/23/2022
3.0.9 604 5/23/2022
3.0.8 625 5/23/2022
2.0.8 1,612 4/2/2021
2.0.7 555 4/1/2021
1.0.7 925 8/15/2020
1.0.6 786 8/15/2020
Loading failed

Reuse authenticated transport pools; local cancellation and timeout safety; .NET Standard 2.0 and .NET 6-10 assets. See README for migration and runtime requirements.