sqlsrv_free_stmt
Libère toutes les ressources associées à l'instruction spécifiée. L'instruction ne peut pas être utilisée à nouveau une fois que cette fonction a été appelée.
Syntaxe
sqlsrv_free_stmt( resource $stmt)
Paramètres
$stmt : instruction à fermer.
Valeur de retour
Valeur booléenne true, à moins que la fonction ne soit appelée à l'aide d'un paramètre non valide. Si la fonction est appelée à l'aide d'un paramètre non valide, la valeur false est retournée.
Remarque : |
---|
Null est un paramètre valide pour cette fonction. Cela permet à la fonction d'être appelée à plusieurs reprises dans un script. Par exemple, si vous libérez une instruction dans une condition d'erreur et si vous la libérez à nouveau à la fin du script, le second appel à sqlsrv_free_stmt retourne true, car le premier appel à sqlsrv_free_stmt (dans la condition d'erreur) définit la ressource d'instruction à null. |
Exemple
L'exemple suivant crée une ressource d'instruction, exécute une requête simple et appelle sqlsrv_free_stmt pour libérer toutes les ressources associées à l'instruction. L'exemple suppose que SQL Server et la base de données AdventureWorks sont installés sur l'ordinateur local. Toutes les données de sortie sont écrites dans la console lorsque l'exemple est exécuté à partir de la ligne de commande.
<?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));
}
$stmt = sqlsrv_query( $conn, "SELECT * FROM Person.Contact");
if( $stmt )
{
echo "Statement executed.\n";
}
else
{
echo "Query could not be executed.\n";
die( print_r( sqlsrv_errors(), true));
}
/*-------------------------------
Process query results here.
-------------------------------*/
/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>
Voir aussi
Référence
Concepts
À propos des exemples de code dans la documentation