sqlsrv_cancel

Articolo
06/02/2023

Annulla un'istruzione. Ciò significa che qualsiasi risultato in sospeso per l'istruzione viene eliminato. Dopo la chiamata a questa funzione, l'istruzione può essere eseguita nuovamente se è stata preparata con sqlsrv_prepare. La chiamata a questa funzione non è necessaria se sono stati usati tutti i risultati associati all'istruzione.

Sintassi

  
sqlsrv_cancel( resource $stmt)

Parametri

$stmt: l'istruzione da annullare.

Valore restituito

Valore booleano: true se l'operazione è riuscita. In caso contrario, false.

Esempio

L'esempio seguente richiede al database AdventureWorks di eseguire una query, quindi usa e conta i risultati fino a quando la variabile $salesTotal non raggiunge una quantità specificata. I risultati restanti della query vengono ignorati. 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));  
}  
  
/* Prepare and execute the query. */  
$tsql = "SELECT OrderQty, UnitPrice FROM Sales.SalesOrderDetail";  
$stmt = sqlsrv_prepare( $conn, $tsql);  
if( $stmt === false )  
{  
     echo "Error in statement preparation.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
if( sqlsrv_execute( $stmt ) === false)  
{  
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Initialize tracking variables. */  
$salesTotal = 0;  
$count = 0;  
  
/* Count and display the number of sales that produce revenue  
of $100,000. */  
while( ($row = sqlsrv_fetch_array( $stmt)) && $salesTotal <=100000)  
{  
     $qty = $row[0];  
     $price = $row[1];  
     $salesTotal += ( $price * $qty);  
     $count++;  
}  
echo "$count sales accounted for the first $$salesTotal in revenue.\n";  
  
/* Cancel the pending results. The statement can be reused. */  
sqlsrv_cancel( $stmt);  
?>

Commenti

Un'istruzione che viene preparata ed eseguita usando la combinazione di sqlsrv_prepare e sqlsrv_execute può essere eseguita nuovamente con sqlsrv_execute dopo la chiamata di sqlsrv_cancel. Un'istruzione eseguita con sqlsrv_query non può essere eseguita nuovamente dopo la chiamata di sqlsrv_cancel.