Azure Cosmos DB .NET Core SDK: Release notes and resources

SDK downloadNuGet
API documentation.NET API reference documentation
Samples.NET code samples
Get startedGet started with the Azure Cosmos DB .NET Core SDK
Web app tutorialWeb application development with Azure Cosmos DB
Current supported framework.NET Standard 1.6 and .NET Standard 1.5

Release Notes

The Azure Cosmos DB .NET Core SDK has feature parity with the latest version of the Azure Cosmos DB .NET SDK.

Note

The Azure Cosmos DB .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 askcosmosdb@microsoft.com.

1.5.0

  • Added support for PartitionKeyRangeId as a FeedOption for scoping query results to a specific partition key range value.
  • Added support for StartTime as a ChangeFeedOption to start looking for the changes after that time.

1.4.1

  • Fixed an issue in the JsonSerializable class that may cause a stack overflow exception.

1.4.0

  • Added support for specifying custom JsonSerializerSettings while instantiating a DocumentClient instance.

1.3.2

  • Supporting .NET Standard 1.5 as one of the target frameworks.

1.3.1

  • Fixed an issue that affected x64 machines that don’t support SSE4 instruction and throw SEHException when running Azure Cosmos DB queries.

1.3.0

  • 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.

1.2.2

  • 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.

1.2.1

  • Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.

1.2.0

  • Fixes to make SDK more resilient to automatic failover under certain conditions.

1.1.2

  • 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.

1.1.1

  • 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.

1.1.0

  • 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.

1.0.0

The Azure Cosmos DB .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 Azure Cosmos DB .NET Core SDK is fully Xamarin compatible and be used to build applications that target iOS, Android, and Mono (Linux).

0.1.0-preview

The Azure Cosmos DB .NET Core Preview SDK enables you to build fast, cross-platform ASP.NET Core and .NET Core apps to run on Windows, Mac, and Linux.

The Azure Cosmos DB .NET Core Preview SDK has feature parity with the latest version of the Azure Cosmos DB .NET SDK and supports the following:

If you have questions related to this SDK, post to StackOverflow, or file an issue in the github repository.

Release & Retirement Dates

Version Release Date Retirement Date
1.5.0 August 10, 2017 ---
1.4.1 August 07, 2017 ---
1.4.0 August 02, 2017 ---
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

See Also

To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.