array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.sqlsrv-execute.php', 1 => 'sqlsrv_execute', 2 => 'Executa uma declaração preparada com sqlsrv_prepare', ), 'up' => array ( 0 => 'ref.sqlsrv.php', 1 => 'Funções SQLSRV', ), 'prev' => array ( 0 => 'function.sqlsrv-errors.php', 1 => 'sqlsrv_errors', ), 'next' => array ( 0 => 'function.sqlsrv-fetch.php', 1 => 'sqlsrv_fetch', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sqlsrv/functions/sqlsrv-execute.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sqlsrv_execute

(No version information available, might only be in Git)

sqlsrv_execute — Executa uma declaração preparada com sqlsrv_prepare()

Descrição

sqlsrv_execute(resource $stmt): bool

Executa uma declaração preparada com sqlsrv_prepare(). Esta função é ideal para executar uma declaração preparada várias vezes com diferentes valores de parâmetro.

Parâmetros

stmt
Um recurso de declaração retornado por sqlsrv_prepare().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de sqlsrv_execute()

Este exemplo demonstra como preparar uma declaração com sqlsrv_prepare() e reexecutá-la várias vezes (com diferentes valores de parâmetro) usando sqlsrv_execute().

<?php
$serverName = "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false) {
die( print_r( sqlsrv_errors(), true));
}

$sql = "UPDATE Table_1
SET OrderQty = ?
WHERE SalesOrderID = ?";

// Inicializa parâmetros e prepara a declaração.
// Variáveis $qty e $id estão vinculadas à declaração, $stmt.
$qty = 0; $id = 0;
$stmt = sqlsrv_prepare( $conn, $sql, array( &$qty, &$id));
if( !$stmt ) {
die( print_r( sqlsrv_errors(), true));
}

// Configura as informações SalesOrderDetailID e OrderQty.
// Este array mapeia o ID do pedido para a quantidade do pedido em pares chave=>valor.
$orders = array( 1=>10, 2=>20, 3=>30);

// Executa a declaração para cada pedido.
foreach( $orders as $id => $qty) {
// Porque $id e $qty estão vinculados a $stmt1, seus valores atualizados
// são usados com cada execução da declaração.
if( sqlsrv_execute( $stmt ) === false ) {
die( print_r( sqlsrv_errors(), true));
}
}
?>

Notas

Quando você prepara uma declaração que usa variáveis como parâmetros, as variáveis são vinculadas à declaração. Isso significa que se você atualizar os valores das variáveis, na próxima vez que executar a declaração, ela será executada com valores de parâmetro atualizados. Para declarações que você planeja executar apenas uma vez, use sqlsrv_query().

Veja Também