Zen v14 ADO.NET Data Provider for .NET Standard 2.0 Release NotesGeneral Release

To create UWP applications, in the application settings you must select a minimum target version of Windows 10 Fall Creators Update (10.0; Build 16299) or later. This setting is available only for UWP projects in Visual Studio if version 10.0.16299 or later of the Windows Software Development Kit is installed on your development system. If your UWP application will target a minimum version of Windows 10 later than 10.0.16299, then the NuGet package for Microsoft.NETCore.UniversalWindowsPlatform that is automatically added to the project by Visual Studio must be version 6.1.9 or later.

Getting Started

The assembly file name for the Zen ADO.NET Data Provider for .NET Standard 2.0 is PSQL.Data.SqlClientStd.dll. Unlike the Zen ADO.NET Data Provider for .NET Framework, this newer assembly is not installed to the .NET Framework Global Assembly Cache (GAC), nor is it installed with the Zen database engine. The new assembly is available only through the NuGet package bundled with this SDK package and must be added to your Visual Studio project.

The NuGet package containing the new provider is supported only by versions of Visual Studio starting with Visual Studio 2017. To add the NuGet package to your Visual Studio project, you must configure the NuGet Package Manager to reference local NuGet packages. This can be done by adding the path to the directory containing local NuGet packages to the Package Sources setting under Tools > Options > NuGet Package Manager.

The steps documented are based on Visual Studio Enterprise 2017. The steps you follow may differ if you are using another version or edition of Visual Studio.

Referencing the Provider

A reference to the Zen ADO.NET Data Provider for .NET Standard 2.0 is added to your Visual Studio project automatically when the NuGet package is added to the project.

►

To create a sample application

This example creates an application that references the provider.

In Visual Studio, create a new project by selecting a project template that can build output compatible with version 2.0 of the .NET Standard specification, such as an application, class library, or runtime component:

•

Console App (.NET Core)

•

Class Library (.NET Standard)

•

Any Universal Windows project template

These steps use the Console App (.NET Core) project template except where noted.

Note Selecting a Universal Windows project template prompts you to choose the target and minimum platform versions that your UWP application will support. You must select minimum version Windows 10 Fall Creators Update (10.0; Build 16299) or later. If this version is not listed, check whether the appropriate version of the Windows Software Development Kit is installed in your development environment.

Under General settings in the Build pane, for the conditional compilation symbols enter NETCOREAPP2.0.

Note If you are using a Universal Windows Blank App project type and your application will need to connect to a Zen database on a remote system, open the package.appxmanifest file and in the Capabilities tab, select Private Networks (Client & Server).

The Zen ADO.NET Data Provider for .NET Standard 2.0 SDK includes a NuGet package named Pervasive.Data.SqlClientStd.4.3.0.nupkg or Pervasive.Data.SqlClientStd.4.4.0.nupkg. In Visual Studio, select Tools > Options > NuGet Package Manager to add this package to the project.

Code your application.

The new provider shares the same namespace, Pervasive.Data.SqlClient, as the Zen ADO.NET Data Provider for .NET Framework but supports only .NET APIs that are part of the .NET Standard 2.0 specification. For instructions on using the provider namespace in your code, see Zen Data Provider for .NET Guide. For more information regarding the .NET APIs supported by the provider for .NET Framework that are not supported for .NET Standard 2.0, see Known Issues and Usage Notes.

You can now build the application.

Documentation

For more information about developing .NET applications, see Zen Data Provider for .NET Guide and Zen Programmer’s Guide in the Zen developer documentation.

Samples

The following table summarizes the samples provided with Zen ADO.NET Data Provider for .NET Standard 2.0 in a directory named Samples.