SDK Setup Guides
...
Release Notes
Ditto v1 for C#
csharp c# c sharp updates version changelog c# / net version 1 1 11 released fri sep 9th 2022, 4 11 pm release notes fixed a very rare deadlock when running on macos or ios and starting sync immediately after creating the ditto instance installation command line install package ditto version 1 1 11 packagereference \<packagereference include="ditto" version=1 1 11" /> https //software ditto live/dotnet/ditto/1 1 11/api reference/ c# / net version 1 1 10 released thu jul 7th 2022, 12 53 pm release notes changed reduced total memory overhead during sync installation command line install package ditto version 1 1 10 packagereference \<packagereference include="ditto" version=1 1 10" /> https //software ditto live/dotnet/ditto/1 1 10/api reference/ c# / net version 1 1 9 released wed jun 15th 2022, 6 27 pm release notes changed reduced crdt memory overhead changed http/websocket service now allows any origin for cors, so it may be used from a webapp on localhost changed a small peer may now act as an authentication service on its http transport fixed a peer using an online identity would fail to sync peer to peer after app restarts installation command line install package ditto version 1 1 9 packagereference \<packagereference include="ditto" version=1 1 9" /> https //software ditto live/dotnet/ditto/1 1 9/api reference/ c# / net version 1 1 9 alpha1 released wed jun 8th 2022, 8 12 pm release notes synchronized version bump release installation command line install package ditto version 1 1 9 alpha1 packagereference \<packagereference include="ditto" version=1 1 9 alpha1" /> https //software ditto live/dotnet/ditto/1 1 9 alpha1/api reference/ c# / net version 1 1 8 released fri jun 3rd 2022, 12 13 am release notes fixed ditto with onlineplaygroundv2 identity would fail to sync with the big peer if internet access isn't available at the time when ditto is instantiated fixed cloud sync would stop working when setting a newly created transport config added a new dittotransportconditionchanged event handler to ditto , allowing to observe the status of network transports deprecated dittoidentity token and replaced with dittoidentity token installation command line install package ditto version 1 1 8 packagereference \<packagereference include="ditto" version=1 1 8" /> https //software ditto live/dotnet/ditto/1 1 8/api reference/ c# / net version 1 1 7 released fri may 13th 2022, 7 18 am release notes synchronized version bump release installation command line install package ditto version 1 1 7 packagereference \<packagereference include="ditto" version=1 1 7" /> https //software ditto live/dotnet/ditto/1 1 7/api reference/ c# / net version 1 1 6 released mon may 9th 2022, 5 04 am release notes fixed a correctness issue in replication when peer permissions changed in the middle of a replication exchange fixed error when querying a collection and there was a type mismatch for a field being used in a comparison in the query fixed restarting an app too quickly could lead to multiple connection attempts to rejoin peers in the mesh fixed apps using changed improvements to ditto mesh performance via fastest available transport prioritization installation command line install package ditto version 1 1 6 packagereference \<packagereference include="ditto" version=1 1 6" /> https //software ditto live/dotnet/ditto/1 1 6/api reference/ c# / net version 1 1 5 released fri apr 8th 2022, 1 00 am release notes synchronized version bump release installation command line install package ditto version 1 1 5 packagereference \<packagereference include="ditto" version=1 1 5" /> https //software ditto live/dotnet/ditto/1 1 5/api reference/ c# / net version 1 1 4 released thu apr 7th 2022, 11 25 pm release notes changed improved replication performance in some scenarios installation command line install package ditto version 1 1 4 packagereference \<packagereference include="ditto" version=1 1 4" /> https //software ditto live/dotnet/ditto/1 1 4/api reference/ c# / net version 1 1 3 released tue mar 22nd 2022, 3 13 am release notes added onlineplaygroundv2 identity allowing for basic authentication for playgrounds deprecated onlineplayground identity, use newly added onlineplaygroundv2 instead fixed document ids are now validated when synced and removed if invalid (some of our early versions of the sdk stored malformed ids under certain circumstances) installation command line install package ditto version 1 1 3 packagereference \<packagereference include="ditto" version=1 1 3" /> https //software ditto live/dotnet/ditto/1 1 3/api reference/ c# / net version 1 1 2 released mon feb 28th 2022, 6 36 am release notes added method deprecated installation command line install package ditto version 1 1 2 packagereference \<packagereference include="ditto" version=1 1 2" /> https //software ditto live/dotnet/ditto/1 1 2/api reference/ c# / net version 1 1 1 released fri feb 11th 2022, 9 38 pm release notes changed optimized the performance of accessing the value of a added experimental mesh roles api added added installation command line install package ditto version 1 1 1 packagereference \<packagereference include="ditto" version=1 1 1" /> https //software ditto live/dotnet/ditto/1 1 1/api reference/ c# / net version 1 1 0 released fri jan 28th 2022, 3 21 am release notes changed improved peer to peer algorithms to create meshes that are more efficient and diverse changed improved routing algorithms for more efficiency changed improved performance of query parsing added property added method added set of apis to observe authentication status (see api reference for added method added property deprecated properties deprecated methods installation command line install package ditto version 1 1 0 packagereference \<packagereference include="ditto" version=1 1 0" /> https //software ditto live/dotnet/ditto/1 1 0/api reference/ c# / net version 1 0 19 released thu dec 23rd 2021, 12 42 pm release notes fixed collections were not appearing in the data browser under certain permission configurations fixed race condition when subscriptions were configured from multiple threads in parallel (sometimes leading to a crash) installation command line install package ditto version 1 0 19 packagereference \<packagereference include="ditto" version=1 0 19" /> https //software ditto live/dotnet/ditto/1 0 19/api reference/ c# / net version 1 0 18 released mon dec 20th 2021, 5 22 am release notes reduced the opportunity for rapid memory growth in some scenarios installation command line install package ditto version 1 0 18 packagereference \<packagereference include="ditto" version=1 0 18" /> https //software ditto live/dotnet/ditto/1 0 18/api reference/ c# / net version 1 0 18 alpha2 released tue dec 14th 2021, 8 32 am release notes improve attachment sync performance installation command line install package ditto version 1 0 18 alpha2 packagereference \<packagereference include="ditto" version=1 0 18 alpha2" /> https //software ditto live/dotnet/ditto/1 0 18 alpha2/api reference/ c# / net version 1 0 18 alpha1 released wed dec 8th 2021, 9 25 am release notes fixed an issue where document ids that were specified inside the document's value as opposed to being specified explicitly (as a separate argument to installation command line install package ditto version 1 0 18 alpha1 packagereference \<packagereference include="ditto" version=1 0 18 alpha1" /> https //software ditto live/dotnet/ditto/1 0 18 alpha1/api reference/ c# / net version 1 0 17 released thu nov 25th 2021, 4 11 pm release notes fix an issue with write strategies not working correctly unexpected results could occur when performing sequences of operations on documents installation command line install package ditto version 1 0 17 packagereference \<packagereference include="ditto" version=1 0 17" /> https //software ditto live/dotnet/ditto/1 0 17/api reference/ c# / net version 1 0 16 released fri nov 19th 2021, 2 39 pm release notes fix an issue with live queries that involved a limit, no offset, at least one document being deleted, and some other conditions being met live queries that met these conditions could report incorrect sets of matching documents fix an issue that could potentially lead to an infinite loop in the replication system, meaning no sync progress would be made installation command line install package ditto version 1 0 16 packagereference \<packagereference include="ditto" version=1 0 16" /> https //software ditto live/dotnet/ditto/1 0 16/api reference/ c# / net version 1 0 15 released fri nov 5th 2021, 3 03 pm release notes ensure that when performing a installation command line install package ditto version 1 0 15 packagereference \<packagereference include="ditto" version=1 0 15" /> https //software ditto live/dotnet/ditto/1 0 15/api reference/ c# / net version 1 0 15 alpha1 released wed oct 27th 2021, 3 33 am release notes synchronized version bump release installation command line install package ditto version 1 0 15 alpha1 packagereference \<packagereference include="ditto" version=1 0 15 alpha1" /> https //software ditto live/dotnet/ditto/1 0 15 alpha1/api reference/ c# / net version 1 0 14 released mon oct 25th 2021, 1 31 am release notes add support for array projections to dittoql deprecate the deprecate the deprecate the installation command line install package ditto version 1 0 14 packagereference \<packagereference include="ditto" version=1 0 14" /> https //software ditto live/dotnet/ditto/1 0 14/api reference/ c# / net version 1 0 13 released mon oct 18th 2021, 10 02 am release notes changed installation command line install package ditto version 1 0 13 packagereference \<packagereference include="ditto" version=1 0 13" /> https //software ditto live/dotnet/ditto/1 0 13/api reference/ c# / net version 1 0 12 released mon oct 18th 2021, 3 00 am release notes added installation command line install package ditto version 1 0 12 packagereference \<packagereference include="ditto" version=1 0 12" /> https //software ditto live/dotnet/ditto/1 0 12/api reference/ c# / net version 1 0 11 released thu oct 7th 2021, 10 09 pm release notes fixed added added method added installation command line install package ditto version 1 0 11 packagereference \<packagereference include="ditto" version=1 0 11" /> https //software ditto live/dotnet/ditto/1 0 11/api reference/ c# / net version 1 0 10 released fri sep 10th 2021, 9 21 am release notes fix to stop a change in site id from leading to an unnecessary error improve handling of persisted authentication data note that this might lead to a one off change to a peer's site id if you weren't and continue to not be specifying an explicit site id when creating your identity installation command line install package ditto version 1 0 10 packagereference \<packagereference include="ditto" version=1 0 10" /> https //software ditto live/dotnet/ditto/1 0 10/api reference/ c# / net version 1 0 9 released fri sep 3rd 2021, 3 38 pm release notes fixed an issue where updated the fixed added support for getting information about all of the collections that the device is aware of this is achieved by accessing added multicast as a transport option to the added new identity types the added a similarly, added a report an error if more than one ditto instance is started using the same working directory installation command line install package ditto version 1 0 9 packagereference \<packagereference include="ditto" version=1 0 9" /> https //software ditto live/dotnet/ditto/1 0 9/api reference/ c# / net version 1 0 8 released mon aug 2nd 2021, 9 19 am release notes improved debug logging installation command line install package ditto version 1 0 8 packagereference \<packagereference include="ditto" version=1 0 8" /> https //software ditto live/dotnet/ditto/1 0 8/api reference/ c# / net version 1 0 7 released thu jul 22nd 2021, 4 38 pm release notes fix bug where sync may fail if an unusually long installation command line install package ditto version 1 0 7 packagereference \<packagereference include="ditto" version=1 0 7" /> https //software ditto live/dotnet/ditto/1 0 7/api reference/ c# / net version 1 0 6 released thu jul 8th 2021, 11 22 am release notes add installation command line install package ditto version 1 0 6 packagereference \<packagereference include="ditto" version=1 0 6" /> https //software ditto live/dotnet/ditto/1 0 6/api reference/ c# / net version 1 0 5 released fri jun 25th 2021, 3 36 pm release notes added a new find function that accepts a query containing placeholders in the form of $args my arg along with a map of query arguments in the form of { "my arg" "some value" } the placeholders in the query will be replaced by a query appropriate representation of the relevant value from the map of query arguments added the ability to get a hash and/or a mnemonic (string) representation of the matching documents from a live query event this means you can do something like this fix for using floats in queries accessing the store property of a ditto instance will no longer throw an error if you have not yet activated your ditto instance with a valid license token deprecated setaccesslicense and added a new function, setlicensetoken , which will throw an appropriate exception if your provided license token is expired or invalid somehow deprecated startsync and added a new function, trystartsync , which will throw an exception if your ditto instance hasn't yet been activated via a successful call to setlicensetoken installation command line install package ditto version 1 0 5 packagereference \<packagereference include="ditto" version=1 0 5" /> https //software ditto live/dotnet/ditto/1 0 5/api reference/ c# / net version 1 0 4 released fri jun 11th 2021, 3 36 pm release notes synchronized version bump release installation command line install package ditto version 1 0 4 packagereference \<packagereference include="ditto" version=1 0 4" /> https //software ditto live/dotnet/ditto/1 0 4/api reference/ c# / net version 1 0 3 released thu jun 10th 2021, 9 34 am release notes synchronized version bump release installation command line install package ditto version 1 0 3 packagereference \<packagereference include="ditto" version=1 0 3" /> https //software ditto live/dotnet/ditto/1 0 3/api reference/ c# / net version 1 0 2 released thu may 20th 2021, 2 39 pm release notes add support for subscripting deprecated installation command line install package ditto version 1 0 2 packagereference \<packagereference include="ditto" version=1 0 2" /> https //software ditto live/dotnet/ditto/1 0 2/api reference/ c# / net version 1 0 1 released tue may 4th 2021, 9 02 am release notes if you provide an invalid query then you will now get a better error message installation command line install package ditto version 1 0 1 packagereference \<packagereference include="ditto" version=1 0 1" /> https //software ditto live/dotnet/ditto/1 0 1/api reference/ c# / net version 1 0 0 released wed apr 21st 2021, 5 29 pm release notes this release is not compatible with any previous sdk releases there are a number of breaking changes both in terms of the sdk api and in terms of the internal systems used by the sdk to perform operations such as synchronization if you have previously made use of the ditto sdk and wish to update to this version then note that you will need to delete all existing ditto data otherwise you will run into errors if you have existing data that you need to keep then please contact us and we can advise you as to how you can migrate your data the most notable api breaking changes are document ids are no longer restricted to just strings you can now create a document id that is a string, integer, boolean, array, map, or null this means that when making the lots of performance improvements and bug fixes installation command line install package ditto version 1 0 0 packagereference \<packagereference include="ditto" version=1 0 0" /> https //software ditto live/dotnet/ditto/1 0 0/api reference/ c# / net version 1 0 0 alpha9 released thu feb 4th 2021, 4 58 pm release notes the exact version of the ditto sdk can now be retrieved using the fixed a bug where mdns advertising may continue after ditto is stopped fixed a hang that could occur creating an attachment fetcher while requesting many attachments at once fixed sync failure when there are multiple overlapping subscriptions or live queries with the same query string for the same collection fixed a potential crash and other sync failures that could occur under certain conditions installation command line install package ditto version 1 0 0 alpha9 packagereference \<packagereference include="ditto" version=1 0 0 alpha9" /> https //software ditto live/dotnet/ditto/1 0 0 alpha9/api reference/ c# / net version 1 0 0 alpha8 released fri jan 22nd 2021, 7 09 am release notes site ids, which make up part of a ditto identity object, are now unsigned, 64 bit integers instead of unsigned 32 bit integers fix a crash that could occur if an offset with a value greater than the number of matching documents was provided installation command line install package ditto version 1 0 0 alpha8 packagereference \<packagereference include="ditto" version=1 0 0 alpha8" /> https //software ditto live/dotnet/ditto/1 0 0 alpha8/api reference/ c# / net version 1 0 0 alpha7 released mon jan 4th 2021, 3 12 am release notes synchronized version bump release installation command line install package ditto version 1 0 0 alpha7 packagereference \<packagereference include="ditto" version=1 0 0 alpha7" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha7/api reference/ c# / net version 1 0 0 alpha6 released mon dec 14th 2020, 5 00 pm release notes performance and stability improvements fix default data insertion such that merge semantics are consistent and duplicate data isn't created installation command line install package ditto version 1 0 0 alpha6 packagereference \<packagereference include="ditto" version=1 0 0 alpha6" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha6/api reference/ c# / net version 1 0 0 alpha5 released mon nov 23rd 2020, 12 30 pm release notes added a new intermediate security identity for a shared secret key this is a simplistic authentication mode which is normally only suitable for private apps where all the users and devices are trusted fixed an issue that prevented counter values from syncing correctly renamed dittoattachmentstatus to dittoattachmentfetchevent and subsequently incomplete status to progre ss installation command line install package ditto version 1 0 0 alpha5 packagereference \<packagereference include="ditto" version=1 0 0 alpha5" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha5/api reference/ c# / net version 1 0 0 alpha4 released mon nov 9th 2020, 10 02 am release notes fix issue where attachments could stop being fetched incorrectly introduce a installation command line install package ditto version 1 0 0 alpha4 packagereference \<packagereference include="ditto" version=1 0 0 alpha4" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha4/api reference/ c# / net version 1 0 0 alpha3 released wed nov 4th 2020, 12 48 am release notes added new observewithnextsignal api to allow the application to control the delivery of the next observe callback ev ent fixed several issues related to attachments that could delay sync simplified log statements installation command line install package ditto version 1 0 0 alpha3 packagereference \<packagereference include="ditto" version=1 0 0 alpha3" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha3/api reference/ c# / net version 1 0 0 alpha2 released wed oct 14th 2020, 11 01 am release notes fixed several potential issues with attachment fetching that may result in the fetch callback not firing installation command line install package ditto version 1 0 0 alpha2 packagereference \<packagereference include="ditto" version=1 0 0 alpha2" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha2/api reference/ c# / net version 1 0 0 alpha1 released fri oct 9th 2020, 10 53 am release notes note that this is a release with breaking changes and clients using releases in the 1 0 series will not be able to communicate with clients running a version that is anything less than 1 0 this should hopefully not be an issue because this release of the sdk has changed the name to be dittosynckit as opposed to dittosharp and the namespace has gone from dittosharp to ditto synckit lots of performance improvements and some bug fixes installation command line install package ditto version 1 0 0 alpha1 packagereference \<packagereference include="ditto" version=1 0 0 alpha1" /> https //software ditto live/dotnet/dittosynckit/1 0 0 alpha1/api reference/