sqlsrv_fetch

下载 PHP 驱动程序

使结果集的下一行可供读取。 sqlsrv_get_field 可用于读取行的字段。

语法

  
sqlsrv_fetch( resource $stmt[, row[, ]offset])  

参数

$stmt：对应于已执行语句的语句资源。

注意

必须执行语句，才可以检索结果。 有关执行语句的信息，请参阅 sqlsrv_query 和 sqlsrv_execute。

row [可选]：下面的值之一，用于指定要在使用可滚动游标的结果集中访问的行：

• SQLSRV_SCROLL_NEXT

• SQLSRV_SCROLL_PRIOR

• SQLSRV_SCROLL_FIRST

• SQLSRV_SCROLL_LAST

• SQLSRV_SCROLL_ABSOLUTE

• SQLSRV_SCROLL_RELATIVE

有关这些值的详细信息，请参阅 指定游标类型和选择行。

offset [可选]：结合使用 SQLSRV_SCROLL_ABSOLUTE 和 SQLSRV_SCROLL_RELATIVE 以指定要检索的行。 结果集中的第一个记录为 0。

返回值

如果已成功检索结果集的下一行，将返回 True 。 如果结果集中没有更多结果，将返回 null 。 如果出现错误，将返回 False 。

示例

以下示例使用 sqlsrv_fetch 检索包含产品审核和审阅者名称的数据行。 若要从结果集中检索数据，请使用 sqlsrv_get_field。 该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。 从命令行运行该示例时，所有输出都将写入控制台。

<?php  
/*Connect to the local server using Windows Authentication and  
specify the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Set up and execute the query. Note that both ReviewerName and  
Comments are of SQL Server type nvarchar. */  
$tsql = "SELECT ReviewerName, Comments   
         FROM Production.ProductReview  
         WHERE ProductReviewID=1";  
$stmt = sqlsrv_query( $conn, $tsql);  
if( $stmt === false )  
{  
     echo "Error in statement preparation/execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Make the first row of the result set available for reading. */  
if( sqlsrv_fetch( $stmt ) === false)  
{  
     echo "Error in retrieving row.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Note: Fields must be accessed in order.  
Get the first field of the row. Note that no return type is  
specified. Data will be returned as a string, the default for  
a field of type nvarchar.*/  
$name = sqlsrv_get_field( $stmt, 0);  
echo "$name: ";  
  
/*Get the second field of the row as a stream.  
Because the default return type for a nvarchar field is a  
string, the return type must be specified as a stream. */  
$stream = sqlsrv_get_field( $stmt, 1,   
                            SQLSRV_PHPTYPE_STREAM( SQLSRV_ENC_CHAR));  
while( !feof( $stream ))  
{   
    $str = fread( $stream, 10000);  
    echo $str;  
}  
  
/* Free the statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

另请参阅

检索数据

SQLSRV 驱动程序 API 参考

文档中相关的代码示例