MongoDBC驱动教程.doc

MongoDB C# 驱动教程 C# 驱动版本 v1.6.x 本教程基于C#驱动 v1.6.x 。 Api 文档见此处：??/csharp/current/?. 本教程介绍由10gen支持的，用于MongoDB的C#驱动。C# 驱动由两个类库组成：BSON Library和C# Driver。 BSON Library 可以独立于 C# Driver 使用。 C# Driver 则必须需要 BSON Library。 你还可能对??C# 驱动序列化教程??感兴趣。它是一个另外的教程因为它涵盖了很多资料。 C# 驱动既有源代码也有二进制文件。BSON Library 和 C# Driver 都存在同一个知识库里，而BSON Library可以独立使用。 原文件可以从????进行下载。 我们使用 msysgit 作为我们的 Windows git 客户端。可以到这里进行下载：??/?. 要复制知识库的话，从git bash shell里运行以下命令： $ cd parentdirectory $ git config --global core.autocrlf true $ git clone git:///mongodb/mongo-csharp-driver.git $ cd mongo-csharp-driver $ git config core.autocrlf true 复制知识库之前，必须将core.autocrlf的全局设置设为true。当复制完毕后，我们建议你将core.autocrlf的本地设置设为true（如上所示），这样将来core.autocrlf的全局设置更改了也不会影响到这个知识库。如果你到时候想把全局设置的core.autocrlf改为false，则运行： $ git config --global core.autocrlf false core.autocrlf设置的典型问题是git 报告整个文件都被修改了（由于行结尾的差异）。在知识库创建后更改core.autocrlf的设置是相当没劲的，所以在开始时就设好它是很重要的。 你可以通过点击以下链接的Downloads按钮来下载源文件的 zip 文件 (不用复制知识库)： /mongodb/mongo-csharp-driver 你可以在以下链接下载二进制文件(.msi 和 .zip 两种格式) ： /mongodb/mongo-csharp-driver/downloads 目前我们使用 Visual Studio 2010 来生成C# 驱动。解决方案的名称是??CSharpDriver-2010.sln?. 单元测试依赖 NUnit 2.5.9，它已包含在知识库的依赖项文件夹中。你可以不用安装NUnit就生成C#驱动，不过要运行单元测试则必须安装NUnit（除非你用别的测试运行器） 有三个工程包含单元测试： 1. BsonUnitTests?2. DriverUnitTests?3. DriverUnitTestsVB BsonUnitTests 不连接 MongoDB 服务端。DriverUnitTests 和 DriverUnitTestsVB 连接一个运行在localhost上默认端口的MongoDB实例。 运行单元测试的一个简单方法是将其中一个单元测试工程设为启动项目并遵照以下说明配置工程(用 BsonUnitTests 做例子)： 在”调试“页签里： 将”启动操作“设为”启动外部程序“ 将外部程序设为：??C:\Program Files (x86)\NUnit 2.5.9\bin\net-2.0\nunit.exe 将“命令行参数”设为：??BsonUnitTests.csproj /config:Debug /run 将“工作目录”设为： ?BsonUnitTest.csproj 所在的目录 如果还想为单元测试运行在Release模式的话，为Release配置重复以上步骤 (使用 /config:Release 代替) 。 nunit.exe的实际路径可能根据你的机器有轻微不同。 要运行 DriverUnitTests 和 DriverUnitTestsVB 执行相同的步骤 (如有必要适当修改). 如果你想安装C#驱动到你的机器上，你可以用安装程序 (见上面的下载说明)。安装程序很简单，只需把DLL复制到指定安装目录即可。 如果你下载了二进制zip文件，只需简单地解压文件并把它们放到任意地方。 注意：如果你下载的是.zip 文件，Windows 可能要你 解除锁定 帮助文件。当你双击?CSharpDriverDocs.chm文件时，?如果 Windows 问你 是否要打开此文件? ，将“每次打开此文件时都询问”旁的复选框勾掉