sqlsrv_fetch_object

(无版本信息可用,可能仅在 Git 中)

sqlsrv_fetch_object将结果集中的下一行数据检索为对象

描述

sqlsrv_fetch_object(
    资源 $stmt,
    字符串 $className = ?,
    数组 $ctorParams = ?,
    整数 $row = ?,
    整数 $offset = ?
): 混合

将结果集中的下一行数据检索为指定类的实例,该实例的属性与行字段名匹配,值与行字段值对应。

参数

stmt

sqlsrv_query()sqlsrv_execute() 创建的语句资源。

className

要实例化的类的名称。如果没有指定类名,将实例化 stdClass。

ctorParams

传递给指定类构造函数的值。如果指定类的构造函数接受参数,则必须提供 ctorParams 数组。

row

要访问的行。此参数只能在指定语句使用可滚动游标准备的情况下使用。在这种情况下,此参数可以取以下值之一

  • SQLSRV_SCROLL_NEXT
  • SQLSRV_SCROLL_PRIOR
  • SQLSRV_SCROLL_FIRST
  • SQLSRV_SCROLL_LAST
  • SQLSRV_SCROLL_ABSOLUTE
  • SQLSRV_SCROLL_RELATIVE

offset

如果 row 参数设置为 SQLSRV_SCROLL_ABSOLUTESQLSRV_SCROLL_RELATIVE,则指定要访问的行。请注意,结果集中的第一行索引为 0。

返回值

成功时返回一个对象,如果不再有行要返回,则返回 null,如果发生错误或指定类不存在,则返回 false

示例

示例 #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 并向错误集合添加错误。
无论是否提供 $className 参数,如果返回了没有名称的字段,则将忽略字段值,并且会向错误集合添加警告。

在使用具有相同名称的多个列的结果集时,最好使用 sqlsrv_fetch_array()sqlsrv_fetch()sqlsrv_get_field() 的组合。

另请参阅

添加备注

用户贡献的备注

此页面没有用户贡献的备注。
To Top