{"id":1561,"date":"2014-12-16T19:23:57","date_gmt":"2014-12-16T19:23:56","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=1561"},"modified":"2025-06-13T23:50:24","modified_gmt":"2025-06-14T06:50:24","slug":"couchbase-net-sdk-138-released-plus-important-release-note","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/couchbase-net-sdk-138-released-plus-important-release-note\/","title":{"rendered":"Couchbase .NET SDK 1.3.8 Released; Plus an Important Release Note!"},"content":{"rendered":"

Today we are releasing version 1.3.8 of the Couchbase .NET SDK. Like the previous couple of 1.X releases, this is a bug fix\/maintanence release. Note that nearly all new development is happening on the 2.0 Version of the .NET SDK, which should be GA early this fall!<\/p>\n

You can download<\/a> the binaries, use nuget to import<\/a> the packages, or checkout the source<\/a> on Github.<\/p>\n

A Very Important Release Note<\/h2>\n

This version (1.3.8) contains a patch that allows this client to function properly with Couchbase Server 3.0, which is currently in Beta, and should be released soon. Note that a breaking change has been found in a feature intended to make Bucket instances more easily identifiable across multiple clusters. A very important feature, but with an unfortunate side-effect; it breaks view queries on versions of the .NET Framework 4.0 and less. The problem is that in those versions of the CLR, IriParsing<\/a> is not enabled by default, thus the unicode encoding it performs internally within System.Uri is not compatible with the Couchbase Server. In versions of the .NET Framework >= 4.5, IriParsing is enabled, therefore it is not an issue on those versions of the CLR.<\/p>\n

Note this was found very late development lifecycle of Couchbase Server, thus the change had to be propogated down to the SDK level. For those of you who cannot or do not want to upgrade to this version (1.3.8) of the Couchbase .NET SDK, there is a work around; you need to add a uri element to your App.Config or Web.Config and enable iriParsing:<\/p>\n

\n
<uri><\/span><\/span><\/span>
\n<iriParsing<\/span> enabled<\/span>=“true”<\/span>\/><\/span><\/span>
\n<\/uri><\/span><\/span><\/span><\/div>\n<\/div>\n

Once you do this, System.Uri will use the correct unicode encoding and the issue will not affect any version of the Couchbase .NET SDK. Note that this is only required for users and customers wishing to use upgrade to Couchbase 3.0 (of course we hope this is everyone ;)).<\/p>\n

Release Notes for 1.3.8<\/h2>\n