Qt4.7文档翻译：QSqlQuery类参考,QSqlQuery Class Reference

• • next ()

• • previous ()

• • first ()

• • last ()

• • seek ()

这些函数允许程序猿在查询返回的记录中向前、向后或者任意地移动。如果你只需要在结果中向前移动（例如，使用 next ()）的话，那么你可以使用 setForwardOnly ()，它会显著地节约一部分内存开销，并且在某些数据库中提升性能。一旦某个活动的查询被放置在一个有效的记录上时，就可以使用 value ()来获取数据。所有的数据都是使用 QVariants 从SQL 后端传输过来的。

示例：

QSqlQuery query("SELECT country FROM artist");

while (query.next()) {

QString country = query.value(0).toString();

doSomething(country);

}

要想访问由一个查询所返回的数据的话，就使用value(int)。由一个 SELECT 语句返回的数据中的每个字段都是通过将那个字段在语句中的位置传递给前面所说的那个函数来访问的，字段位置从0 开始。从这一点来看，是不建议使用 SELECT * 查询的，因为返回的字段的顺序是不确定的。

为咯效率上的考虑，没有提供按照名字来访问字段的函数（除非你使用预处理的（prepared）带有名字的查询，下面会说到）。要将一个字段名字转换成索引（index）的话，就使用 record (). indexOf() ，例如：

QSqlQuery query("SELECT * FROM artist");

int fieldNo = query.record().indexOf("country");

while (query.next()) {

QString country = query.value(fieldNo).toString();

doSomething(country);

}

QSqlQuery支持执行预处理的查询，以及将参数的值与占位符绑定。某些数据库不支持这些特性，所以，对于那些数据库，Qt会模仿（emulates）那些必要的功能。例如，Oracle和ODBC驱动程序提供咯可用的预处理查询的支持，因此Qt 直接使用它们的功能；但是对于那些不支持这个功能的数据库勒，Qt会自己实现这个特性，比如说，在一个查询被执行的时候将占位符替换成实际的值。使用 numRowsAffected ()来获知有多少行被一个非 SELECT 查询影响，使用 size ()来获知一个 SELECT 查询返回咯多少行数据。

Oracle数据库使用“ 冒号 名字 ”的语法来识别占位符，比如说 :name 。ODBC简单地使用 ? 字符。Qt同时支持这两种语法，只是有一个限制：你不能将它们在同一个查询中混合使用。

你可以使用 boundValues ()来将所有字段的值提取到单个变量（一个映射（map））中。

在下面，我们展示的是同一个例子，其中使用咯四种绑定方法中的每一种，并且还有一个例子是将值绑定到一个存储过程的。

使用命名（named）的占位符进行的命名（Named）绑定：

QSqlQuery query;

query.prepare("INSERT INTO person (id, forename, surname) "

"VALUES (:id, :forename, :surname)");

query.bindValue(":id", 1001);

query.bindValue(":forename", "Bart");

query.bindValue(":surname", "Simpson");

query.exec();

使用命名占位符进行的位置（Positional）绑定：

QSqlQuery query;

query.prepare("INSERT INTO person (id, forename, surname) "

"VALUES (:id, :forename, :surname)");

query.bindValue(0, 1001);

query.bindValue(1, "Bart");

query.bindValue(2, "Simpson");

query.exec();

使用位置占位符进行的绑定（版本1）：

QSqlQuery query;

query.prepare("INSERT INTO person (id, forename, surname) "

"VALUES (?, ?, ?)");

query.bindValue(0, 1001);

query.bindValue(1, "Bart");

query.bindValue(2, "Simpson");

query.exec();

使用位置占位符进行的绑定（版本 2）：

QSqlQuery query;

query.prepare("INSERT INTO person (id, forename, surname) "

"VALUES (?, ?, ?)");

query.addBindValue(1001);

query.addBindValue("Bart");

query.addBindValue("Simpson");

query.exec();

将值绑定到一个存储过程中：

这段代码调用一个叫做 AsciiToInt() 的存储过程，通过输入（in）参数传递一个字符给它，再通过输出（out）参数取得它的结果。

QSqlQuery query;

query.prepare("CALL AsciiToInt(?, ?)");

query.bindValue(0, "A");

query.bindValue(1, 0, QSql::Out);

query.exec();

int i = query.boundValue(1).toInt(); // i是65

注意：被解除绑定（unbound）的参数会保持它们的值。