sqlsrv_free_stmt

  • 發行項

下載 PHP 驅動程式

釋出所有與指定的陳述式相關聯的資源。 在呼叫此函數後，無法再次使用陳述式。

語法

  
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 驅動程式 API 參考

關於文件中的程式碼範例

sqlsrv_cancel