|API documentation||.NET API reference documentation|
|Samples||.NET code samples|
|Get started||Get started with the DocumentDB .NET Core SDK|
|Web app tutorial||Web application development with DocumentDB|
|Current supported framework||.NET Standard 1.6 and .NET Standard 1.5|
The DocumentDB .NET Core SDK has feature parity with the latest version of the DocumentDB .NET SDK.
The DocumentDB .NET Core SDK is not yet compatible with Universal Windows Platform (UWP) apps. If you are interested in the .NET Core SDK that does support UWP apps, send email to email@example.com.
- Supporting .NET Standard 1.5 as one of the target frameworks.
- Fixed an issue that affected x64 machines that don’t support SSE4 instruction and throw SEHException when running DocumentDB queries.
- Added support for Request Unit per Minute (RU/m) feature.
- Added support for a new consistency level called ConsistentPrefix.
- Added support for query metrics for individual partitions.
- Added support for limiting the size of the continuation token for queries.
- Added support for more detailed tracing for failed requests.
- Made some performance improvements in the SDK.
- Fixed an issue that ignored the PartitionKey value provided in FeedOptions for aggregate queries.
- Fixed an issue in transparent handling of partition management during mid-flight cross-partition Order By query execution.
- Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.
- Fixes to make SDK more resilient to automatic failover under certain conditions.
- Fix for an issue that occasionally causes a WebException: The remote name could not be resolved.
- Added the support for directly reading a typed document by adding new overloads to ReadDocumentAsync API.
- Added LINQ support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
- Fix for a memory leak issue for the ConnectionPolicy object caused by the use of event handler.
- Fix for an issue wherein UpsertAttachmentAsync was not working when ETag was used.
- Fix for an issue wherein cross partition order-by query continuation was not working when sorting on string field.
- Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). See Aggregation support.
- Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.
The DocumentDB .NET Core SDK enables you to build fast, cross-platform ASP.NET Core and .NET Core apps to run on Windows, Mac, and Linux. The latest release of the DocumentDB .NET Core SDK is fully Xamarin compatible and be used to build applications that target iOS, Android, and Mono (Linux).
The DocumentDB .NET Core Preview SDK has feature parity with the latest version of the DocumentDB .NET SDK and supports the following:
- All connection modes: Gateway mode, Direct TCP, and Direct HTTPs.
- All consistency levels: Strong, Session, Bounded Staleness, and Eventual.
- Partitioned collections.
- Multi-region database accounts and geo-replication.
Release & Retirement Dates
|Version||Release Date||Retirement Date|
|1.3.2||June 12, 2017||---|
|1.3.1||May 23, 2017||---|
|1.3.0||May 10, 2017||---|
|1.2.2||April 19, 2017||---|
|1.2.1||March 29, 2017||---|
|1.2.0||March 25, 2017||---|
|1.1.2||March 20, 2017||---|
|1.1.1||March 14, 2017||---|
|1.1.0||February 16, 2017||---|
|1.0.0||December 21, 2016||---|
|0.1.0-preview||November 15, 2016||December 31, 2016|
To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.