MongoDB的C＃驱动程序教程.doc

1.概述 本教程是10gen支持C＃驱动程序MongoDB的介绍。假定您熟悉使用MongoDB，因此主要集中在如何使用C＃访问MongoDB的。 它分为两个部分：C＃ 驱动程序 ，BSON图书馆。C＃驱动程序是建立在顶部，其目的是单独使用的C＃驱动程序的的BSON图书馆，。 在第1部分中，我们将介绍C＃驱动程序的主类：MongoServer，MongoDatabase，MongoCollection，MongoCursor，MongoGridFS，MongoGridFSFileInfo和SafeMode。 在第2部分，我们将讨论的主要类的BSON Library的：BsonType，BsonValue（及其子类），BsonElement，BsonDocument和BsonArray。 第1部分：C＃驱动程序 本教程的第1部分组织自顶向下的方式，所以你有时可能提前偷看，如果事情是没有意义。您甚至可能想要读第2，如果你是完全陌生的的BSON概念，如文档和元素与前第1部分。 参考文献和命名空间 为了从你的程序中使用C＃的驱动程序，您必须添加以下两个DLL文件： MongoDB.BsonLibrary.dll MongoDB.CSharpDriver.dll 您还应该添加以下语句到你的源文件： using MongoDB.BsonLibrary; using MongoDB.CSharpDriver; 除了 极少数例外，你将要使用的类的名称前缀与任何“BSON”的，如果他们的BsonLibrary或“Mongo”的一部分，如果他们的C＃驱动程序的一部分 。这样做是为了获得名称冲突的可能性降至最低，当您添加到你的程序的两个使用语句。预计将方法的参数（主要是枚举和标志）的一些类，具有较短的名称，不使用任何前缀。 我们喜欢使用C＃的var语句声明 的变量，因为它会导致更短，我们的感觉，更可读的代码。Visual Studio可以很容易地看到一个变量的类型 ，如果您需要通过将鼠标指针悬停在变量 或使用IntelliSense。然而，当阅读本文档，你没有这个能力，所以在这个文件中，而不是写： var server = MongoServer.Create(connectionString); var test = server[“test”]; var books = test[“books”]; 按照我们的建议，我们会来写： MongoServer server = MongoServer.Create(connectionString); MongoDatabase test = server[“test”]; MongoCollectionBsonDocument books = test[“books”]; 所以，你可以看到什么类型正在使用。 线程安全 只有少数的C＃驱动程序 类是线程安全的。其中：MongoServer的，MongoDatabase，MongoCollection MongoGridFS。通用类，你会使用很多是不是线程安全包括MongoCursor的所有类的BsonLibrary（除 BsonSymbolTable）的。A类不是线程安全的，除非特别记载是线程安全的。 所有的所有类的静态属性和方法是线程安全的。 MongoServer类 这个类服务 s的工作与MongoDB的根对象。这个类的一个实例的客户端是一个MongoDB服务器，你想沟通。虽然这个类有公共的构造函数，推荐的方式来获得这个类的一个实例是使用工厂方法。 每个实例MongoServer保持与服务器的连接池。这些连接之间共享所有的呼叫到服务器。你可能要调用构造函数，而不是直接调用创建工厂方法MongoServer的几个原因之一是，如果你要保持一个单独的连接池的一些操作。 这个类的实例是线程安全的。 连接字符串 最简单的方法是使用一个连接字符串连接到MongoDB的。标准 MongoDB的连接字符串的格式是一个以下列格式的URL： mongodb://[username:password@]hostname[:port][/database] 如果您使用的是MongoDB服务器的身份验证的用户名和密码，只应。这些凭据将适用于一个单一的数据库，如果数据库名称是存在的，否则他们将所有的数据库的默认凭据。要进行身份验证对管理数据库追加“（管理）”的用户名的。 端口号是可选的，默认为27017。 如果数据库名是存在的，那么这个连接字符串，也可以与创建方法Mon