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

關於文件中的程式碼範例