C#专用接口应用编程的基本步骤
C#为面向对象编程语言,对数据库编程中须要用到的类有XuguConnection、XuguCommand。常用的类有XuguParameters、XuguDataReader、XuguDataAdapter等。
常规应用的一般顺序为:
- 申明连接对象XuguConnection,赋值连接串设定连接信息,建立与数据库服务器的连接。
- 申明执行命令对象XuguCommand,设定其连接属性为上述连接对象。设定与数据库交互的SQL语句,有参数进行参数绑定,选择适当的执行方法调用XuguCommand与数据库交互。有结果集返回则接收结果集,将结果集返回提供给XuguDataReader对象供用户访问。
- 释放XuguCommand对象。
- 释放XuguConnection对象。
操作示例如下:
Using XuguClient;
XuguConnection conn= new XuguConnection();
Conn.ConnectionString=”IP=192.168.2.214;DB=SYSTEM;User=SYSDBA;PWD=SYSDBA;Port=5138;AUTO_COMMIT=on;CHAR_SET=GBK”;
Try{
Conn.Open();
XuguCommand mycmd= new XuguCommand();
mycmd.Connection=conn;
mycmd.CommandText=”update t1 set it=5 where pid=1 ”;
int effect= mycmd.ExecuteNonQuery();
mycmd.Dispose();
}
Catch(Exception ei)
{
Console.WriteLine(ei.ToString());
}
Finally{
conn.Close();
}
上述代码是与数据库交互的简单示例:引用虚谷驱动,建立并打开了一个数据库的连接,将t1表中的pid=1的数据的it值置为5; 最终返回值为影响的行数,当表中没有数据符合筛选条件pid=1时,影响的行数为0。
设置正确的会话连接参数和建立数据库连接是操作数据库的基础和前提。
与数据库交互的命令类 XuguCommand 类对象:
- 可以设置SQL语句。
- 可以设定参数。
- 可以设置事务。
- 用户可根据是否需要返回结果或者结果集,选择ExecuteNoneQuery()、ExecuteScalar()、ExecuteReader()等不同的执行方式。
当收到结果集时可以选择XuguDataReader对象浏览数据集,也可以选择XuguDataAdapte对象,将数据填入 DataSet或者DataTable。
说明:
- 使用XuguDataAdapter对象结合以上公共控件进行访问时在单表结果集的情况下可以修改结果集的数据,反向同步至数据库端。
- 完成与数据库的交互操作之后,需要关闭相应的类对象释放相关的资源,关闭连接,避免不再使用的资源不能及时释放而增加开销。如不及时释放,有因当前连接数过多而导致新连接不能建立的风险。