sqlsrv_rows_affected
傳回上次執行之陳述式所修改的資料列數目。 此函數不會傳回 SELECT 陳述式所傳回的資料列數目。
語法
sqlsrv_rows_affected( resource $stmt)
參數
$stmt：對應至執行之陳述式的陳述式資源。
傳回值
一個整數，表示上次執行的陳述式所修改的資料列數目。 如果未修改任何資料列，則會傳回零 (0)。 如果已修改的資料列數目沒有相關資訊可供參考，則會傳回負一 (-1)。 如果在擷取已修改的資料列數目時發生錯誤，則會傳回 false 。
範例
下列範例顯示 UPDATE 陳述式所修改的資料列數目。 此範例假設本機電腦上已安裝 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 Transact-SQL query. */
$tsql = "UPDATE Sales.SalesOrderDetail
SET SpecialOfferID = ?
WHERE ProductID = ?";
/* Set parameter values. */
$params = array(2, 709);
/* Execute the statement. */
$stmt = sqlsrv_query( $conn, $tsql, $params);
/* Get the number of rows affected and display appropriate message.*/
$rows_affected = sqlsrv_rows_affected( $stmt);
if( $rows_affected === false)
{
echo "Error in calling sqlsrv_rows_affected.\n";
die( print_r( sqlsrv_errors(), true));
}
elseif( $rows_affected == -1)
{
echo "No information available.\n";
}
else
{
echo $rows_affected." rows were updated.\n";
}
/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>