sqlsrv_num_fields

下载 PHP 驱动程序

检索活动结果集中的字段数目。 可以对任何已准备的语句调用此函数,不管是执行前还是执行后。

语法

  
sqlsrv_num_fields( resource $stmt)  

参数

$stmt:目标结果集在其中处于活动状态的语句。

返回值

表示活动结果集中的字段数目的整数值。 如果发生错误,将返回布尔值 false

示例

以下示例执行查询来检索 AdventureWorks 数据库的 HumanResources.Department 表中前三行的所有字段。 sqlsrv_num_fields 函数确定结果集中的字段数目。 这允许数据通过迭代浏览每个返回行中的字段显示。

该示例假定已在本地计算机上安装了 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));  
}  
  
/* Define and execute the query. */  
$tsql = "SELECT TOP (3) * FROM HumanResources.Department";  
$stmt = sqlsrv_query($conn, $tsql);  
if( $stmt === false)  
{  
     echo "Error in executing query.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve the number of fields. */  
$numFields = sqlsrv_num_fields( $stmt );  
  
/* Iterate through each row of the result set. */  
while( sqlsrv_fetch( $stmt ))  
{  
     /* Iterate through the fields of each row. */  
     for($i = 0; $i < $numFields; $i++)  
     {  
          echo sqlsrv_get_field($stmt, $i,   
                   SQLSRV_PHPTYPE_STRING(SQLSRV_ENC_CHAR))." ";  
     }  
     echo "\n";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt );  
sqlsrv_close( $conn );  
?>  

另请参阅

SQLSRV 驱动程序 API 参考

sqlsrv_field_metadata

文档中相关的代码示例