共用方式為


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

另請參閱

參考

sqlsrv_cancel

概念

有關文件集中的程式碼範例

其他資源

API 參考 (SQL Server Driver for PHP)