Npgsql - 用户手册

Npgsql: 用户的手册

Copyright ©The Npgsql Development Team

Last update: $Date: 2009/12/20 02:33:47 $ by $Author: fxjr $

Category: External documentation

Intended Audience: Npgsql Users

1. What is Npgsql?

Npgsql 是一个.net的资料提供者为postgresql的数据库服务器

它允许一个.net客户端应用程序(控制台,WinForms,ASP的。网络、网络服务…)发送和接收数据与postgresql的服务器。它正在积极开发基于指南规定在.net文档。

2. How to get and compile Npgsql 如何获得和编译Npgsql

2.1 Binary package 二进制包

你可以下载Npgsql编译为MS . 在里面编写.net的项目。

这个包裹里,你会发现下面的目录的布局。

Npgsql/bin/docs - Documentation

Npgsql/bin/docs/apidocs - API Documentation

Npgsql/bin/ms1.1 - Npgsql compiled for 1.1

Npgsql/bin/mono - Npgsql compiled for Mono

As soon as Npgsql is released on other platforms/versions, they will be added accordingly to this layout.

2.2 Installing binary package 安装二进制包

为了查找到。net运行时,文件Npgsql.dll必须放置在你的应用程序目录——除非你指定另一个目录作为通往私营成分通过一个配置文件(使用探测单元)。请看看。net除有关如何运行(位于)总成,被载入。确切地说,前面可以称为”通往私人组件"

在ASP。网络和网络服务的应用程序中,必须有一个叫做“bin”的应用与目录. 举例来说,如果应用程序目录被称为“ASPNETApplication”,然后Npgsql.dll和Mono.Security.dll必须放置在“ASPNETApplication \bin”的目录. 如果这些文件是不正确的目录,你可以看到编译器生成错误代码,使用Npgsql类。

或者,你可以把Npgsql装配在解决。自从版本0.4,Npgsql强烈签字——这意味着你可以用“gacutil "安装它。

下列命令:

gacutil - Npgsql.dll

请参阅“安装装配在全球缓存汇编”部分的单据MSDN来获得更多信息.利用gac的意义,你应该充分理解,沿着这条路。

注意,放置在……要求Npgsql设计时间支持.net可视化工作室。

(Npgsql编制单声道不需要Mono.Security.dll作为已经融入单声道运行。)

一旦你拷贝或设置组件,你准备去试试这个例子——跳转到section 3.

2.3 Getting Npgsql from CVS 获得Npgsql到CVS

让Npgsql到CVS,使用下列资料储存在你的客户信息

Server:

Repository: /cvsroot/npgsql

Module name: Npgsql2

User: anonymous

Password:

If you are using CVS from a command line, use this command:

cvs-d:pserver:***********************.org:/cvsroot/npgsqllogin

Hit the Enter key when prompted for a password (none required):

cvs-d:pserver:***********************.org:/cvsroot/npgsqlcheckoutNpgsql2 The code will begin transferring:

$cvs-d:pserver:***********************.org:/cvsroot/npgsqllogin

Logginginto:pserver:***********************.org:2401/cvsroot/npgsql

CVS password:

$cvs-d:pserver:***********************.org:/cvsroot/npgsqlcoNpgsql2

cvs checkout: Updating Npgsql2

cvs checkout: Updating Npgsql2/admin

U Npgsql2/admin/release.pl

cvs checkout: Updating Npgsql/docs

U Npgsql2/docs/Npgsql.zargo

U Npgsql2/docs/NpgsqlConnectionStateMachine.png

U Npgsql2/docs/SuggestedReadings.htm

...

2.4 Compiling Npgsql 编译Npgsql

官方支持Npgsql编制方法是0.86版本. 版本0.86是必要的,因为它已经支持编译颗卫星资源总成。

仅仅从Npgsql /src/ Npgsql文件夹。它将创建一个文件夹名为“build”,看到了“build / ms”文件夹中产生的组件。

我们也有项目文件为MonoDevelop、视觉工作室网络和可视化工作室.net2008年。

2.5 Running Npgsql Unit tests Npgsql运行单元测试

为了能够跑nunit测试,你必须首先设置你的测试数据库。

首先,创建一个数据库称为npgsql_tests:

createdb npgsql_tests

再来,创建一个用户称为npgsql_tests与密码:

createuser -NP npgsql_tests

现在,运行脚本加表、功能、数据等。这些脚本是位于testsuite / noninteractive文件夹。

nUnit运行测试,简单地跑。

3. Npgsql Usage Npgsql用法

这部分解释了Npgsql使用.net应用程序中(窗口或net)。如果你是一个有经验的数据访问应用程序中使用Sql服务器、OleDB或ODBC网络供应商,你会发现Npgsql与其非常相似,在很多方面同样或具有更强的鲁棒性,并由一个活跃的社区。

为了使用Npgsql,p ostgresql的服务器必须遵守TCP / IP协议。TCP协议是默认在8.0级+服务器。以前的版本应该开始以“-i”选项。检查详情:

/docs/7.4/static/postmaster-start.html

注:Npgsql仍处于发展阶段。只会显示当前支持特征。作为Npgsql日趋成熟,会有更多的功能。Adding required namespaces to your source file 添加到源文件要求的命名空间

首先,要获得到Npgsql对象(如下)。Intellisense在.net可视化工作室),需要指示编译器使用Npgsql命名空间。当你操纵数据反演,课程体系Npgsql…数据还将被调用。在c#,加上这个指令到适当的网页或类: using System.Data;

using Npgsql;