sqlsrv_free_stmt
釋出所有與指定的陳述式相關聯的資源。 在呼叫此函數後,無法再次使用陳述式。
語法
sqlsrv_free_stmt( resource $stmt)
參數
$stmt:要關閉的陳述式。
傳回值
除非使用無效的參數呼叫函數,否則為布林值 true 。 如果使用無效的參數呼叫函數,則傳回 false 。
注意
Null 是此函數的有效參數。 這可讓函數在指令碼中多次呼叫。 例如,如果您在錯誤狀況下釋出陳述式,並且在指令碼結束時再次加以釋出,則在第二次呼叫 sqlsrv_free_stmt 時將會傳回 true,因為第一次呼叫 sqlsrv_free_stmt 時 (在錯誤狀況下) 已將陳述式資源設定為 null。
範例
下列範例會建立陳述式資源、執行簡單查詢,並呼叫 sqlsrv_free_stmt 以釋出所有與陳述式相關聯的資源。 此範例假設本機電腦上已安裝 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));
}
$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);
?>