sqlsrv_rows_affected

發行項
11/05/2009

傳回由最後一個執行之陳述式所修改的資料列數目。這個函數不會傳回 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);
?>

Share via

sqlsrv_rows_affected

語法

參數

傳回值

範例

另請參閱

概念

其他資源

其他資源