sqlsrv_rows_affected

下载 PHP 驱动程序

返回由上次执行的语句修改的行数。 此函数不返回由 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);  
?>  

另请参阅

SQLSRV 驱动程序 API 参考

文档中相关的代码示例

更新数据 (Microsoft Drivers for PHP for SQL Server)