sqlsrv_execute

Artículo
06/02/2023

Ejecuta una instrucción preparada previamente. Consulte sqlsrv_prepare para obtener información sobre cómo preparar una instrucción para ejecutarla.

Nota

Esta función es perfecta para ejecutar una instrucción preparada varias veces con distintos valores de parámetro.

Sintaxis

  
sqlsrv_execute( resource $stmt)

Parámetros

$stmt: recurso que especifica la instrucción que se ejecutará. Para obtener más información sobre cómo crear un recurso de instrucción, consulte sqlsrv_prepare.

Valor devuelto

Se devuelve un valor booleano True si la instrucción se ha ejecutado correctamente. De lo contrario, se devuelve el valor False.

Ejemplo

En el ejemplo siguiente se ejecuta una instrucción que actualiza un campo de la tabla Sales.SalesOrderDetail de la base de datos AdventureWorks. En el ejemplo se da por hecho que SQL Server y la base de datos de AdventureWorks están instalados en el equipo local. Los resultados se agregan a la consola cuando se ejecuta el ejemplo en la línea de comandos.

<?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));  
}  
  
/* Set up the Transact-SQL query. */  
$tsql = "UPDATE Sales.SalesOrderDetail   
         SET OrderQty = ( ?)   
         WHERE SalesOrderDetailID = ( ?)";  
  
/* Set up the parameters array. Parameters correspond, in order, to  
question marks in $tsql. */  
$params = array( 5, 10);  
  
/* Create the statement. */  
$stmt = sqlsrv_prepare( $conn, $tsql, $params);  
if( $stmt )  
{  
     echo "Statement prepared.\n";  
}  
else  
{  
     echo "Error in preparing statement.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Execute the statement. Display any errors that occur. */  
if( sqlsrv_execute( $stmt))  
{  
      echo "Statement executed.\n";  
}  
else  
{  
     echo "Error in executing statement.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Free the statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

Consulte también

Referencia de API del controlador SQLSRV

Sobre los ejemplos de código de la documentación

sqlsrv_query