sqlsrv_rows_affected

Articolo
06/02/2023

Restituisce il numero di righe modificate dall'ultima istruzione eseguita. Questa funzione non restituisce il numero di righe restituite da un'istruzione SELECT.

Sintassi

  
sqlsrv_rows_affected( resource $stmt)

Parametri

$stmt: risorsa di istruzione corrispondente a un'istruzione eseguita.

Valore restituito

Valore intero che indica il numero di righe modificate dall'ultima istruzione eseguita. Se nessuna riga è stata modificata, viene restituito il valore zero (0). Se non sono disponibili informazioni sul numero di righe modificate, viene restituito il valore uno negativo (-1). Se si è verificato un errore nel recupero del numero di righe modificate, viene restituito false .

Esempio

L'esempio seguente visualizza il numero di righe modificate da un'istruzione UPDATE. Nell'esempio si presuppone che SQL Server e il database AdventureWorks siano installati nel computer locale. Quando si esegue l'esempio dalla riga di comando, tutto l'output viene scritto nel browser.

<?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);  
?>

Vedere anche

Riferimento all'API del driver SQLSRV

Informazioni sugli esempi di codice nella documentazione

Aggiornamento dei dati (Driver Microsoft per PHP per SQL Server)