Known Issues & Workarounds

PDF for offline use
Related Links:

Let us know how you feel about this

Translation Quality


0/250

Persistence of CultureInfo across cells

Setting System.Threading.CurrentThread.CurrentCulture or System.Globalization.CultureInfo.CurrentCulture does not persist across workbook cells on Mono-based Workbooks targets (Mac, iOS, and Android) due to a bug in Mono's AppContext.SetSwitch implementation.

Workarounds

  • Set the application-domain-local DefaultThreadCurrentCulture:
using System.Globalization;
CultureInfo.DefaultThreadCurrentCulture = new CultureInfo("de-DE")
  • Or, update to Workbooks 1.2.1 or newer , which will rewrite assignments to System.Threading.CurrentThread.CurrentCulture and System.Globalization.CultureInfo.CurrentCulture to provide for the desired behavior (working around the Mono bug).

Unable to use Newtonsoft.Json

Workaround

  • Update to Workbooks 1.2.1, which will install Newtonsoft.Json 9.0.1. A future Workbooks update will support versions 10 and newer.

Details

Newtonsoft.Json 10 was released which bumped its dependency on Microsoft.CSharp which conflicts with the version Workbooks ships to support dynamic. This will be fully addressed in a subsequent Workbooks release, but for now we have worked around this by pinning Newtonsoft.Json specifically to version 9.0.1.

Unfortunately, NuGet packages explicitly depending on Newtonsoft.Json 10 or newer cannot be used in Workbooks at the moment.

Code Tooltips are Blank

There is a bug in the Monaco editor in Safari/WebKit, which is used in the Mac Workbooks app, that results in code tooltips rendering without text.

Workaround

  • Clicking on the tooltip after it appears will force the text to render.

  • Or update to Workbooks 1.2.1 or newer

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.