(无版本信息可用,可能仅存在于 Git 中)
sqlsrv_fetch_object — 将结果集中的下一行数据作为对象检索
$stmt
,$className
= ?,$ctorParams
= ?,$row
= ?,$offset
= ?将结果集中的下一行数据作为指定类的实例检索,该实例的属性与行字段名称匹配,并且值与行字段值对应。
stmt
由 sqlsrv_query() 或 sqlsrv_execute() 创建的语句资源。
className
要实例化的类的名称。如果未指定类名,则实例化 stdClass。
ctorParams
传递给指定类构造函数的值。如果指定类的构造函数需要参数,则必须提供 ctorParams 数组。
row
要访问的行。此参数仅在指定语句使用可滚动游标准备时才能使用。在这种情况下,此参数可以采用以下值之一
offset
如果 row 参数设置为 SQLSRV_SCROLL_ABSOLUTE
或 SQLSRV_SCROLL_RELATIVE
,则指定要访问的行。请注意,结果集中的第一行索引为 0。
示例 #1 sqlsrv_fetch_object() 示例
以下示例演示如何将一行作为 stdClass 对象检索。
<?php
$serverName = "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false ) {
die( print_r( sqlsrv_errors(), true));
}
$sql = "SELECT fName, lName FROM Table_1";
$stmt = sqlsrv_query( $conn, $sql);
if( $stmt === false ) {
die( print_r( sqlsrv_errors(), true));
}
// 将每一行作为对象检索。
// 由于没有指定类,因此每一行都将作为 stdClass 对象检索。
// 属性名称对应于字段名称。
while( $obj = sqlsrv_fetch_object( $stmt)) {
echo $obj->fName.", ".$obj->lName."<br />";
}
?>
如果使用可选的 $className 参数指定了类名,并且该类具有名称与结果集字段名称匹配的属性,则相应的结果集值将应用于这些属性。如果结果集字段名称与类属性不匹配,则向对象添加一个具有结果集字段名称的属性,并将结果集值应用于该属性。使用 $className 参数时,适用以下规则
false
并向错误集合添加错误。当使用具有多个同名字段的结果集时,最好使用 sqlsrv_fetch_array() 或 sqlsrv_fetch() 和 sqlsrv_get_field() 的组合。