【SQLite】ClickOnce 形式部署 WPF + SQLite + Entityframework 时的注意事项

背景

开发 WPF 应用程序，使用 EntityFramework 访问 SQLite 数据库，并以 ClickOnce 形式发布。

 

问题现象

安装 ClickOnce 程序后，执行到 Entityframework 代码，抛出异常 Unable to find the requested .Net Framework Data Provider。

 

问题原因

客户电脑上没有安装过 SQLite 的 Data Provider，所以在 machine.config 中没有对应的配置项，GAC 中也没有对应的 dll，需要手动配置。

 

解决步骤

1. 在 app.config 中添加配置项
   

   <system.data>
       <DbProviderFactories>
         <!--<add name="SQLite Data Provider" invariant="System.Data.SQLite" description=".NET Framework Data Provider for SQLite" type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite, Version=1.0.93.0, Culture=neutral, PublicKeyToken=db937bc2d44ff139" />-->
         <remove invariant="System.Data.SQLite" />
         <add name="SQLite Data Provider" invariant="System.Data.SQLite" description=".Net Framework Data Provider for SQLite"
              type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite" />
       </DbProviderFactories>
     </system.data>
   

   注意，以上配置项中未使用程序集的全名，这样就可以在 exe 文件附近寻找 dll。被注释的配置项使用了程序集全名，这样会在 GAC 中寻找 dll。

2. 把 System.Data.SQLite.dll 和 System.Data.SQLite.Linq.dll 复制到 exe 文件旁。

 

ClickOnce 发布说明

数据库文件、System.Data.SQLite.dll、System.Data.SQLite.Linq.dll 这三个文件需要以 Data File 的形式发布到客户电脑，Data File 的发布方式见以下链接：

http://msdn.microsoft.com/en-us/library/vstudio/dd465298(v=vs.100).aspx

1. 以 Add as Link 方式，添加三个文件到工程中。
2. 分别设置三个文件的 Copy to Output Directory property 为 Copy always。

 

安装前提条件（重要）

如果实施了以上步骤，问题仍然存在的话，那么应该反过来思考，是否在安装前，缺少某些组件之类的前提条件。

System.Data.SQLite Download Page 这个网页中明确的说明了 SQLite 需要 Microsoft Visual C++ Runtime Library，如果目标电脑上没有安装，那么错误仍然会出现。

注：仅复制 msvcr100.dll 是不能解决问题的。

在 ClickOnce 也就是工程属性的 Publish 标签页中，可以设置 Microsoft Visual C++ Runtime Library 为前提条件。