<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.sqlsrv.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.sqlsrv-execute.php',
    1 => 'sqlsrv_execute',
    2 => 'Ejecuta una sentencia preparada con sqlsrv_prepare',
  ),
  'up' => 
  array (
    0 => 'ref.sqlsrv.php',
    1 => 'SQLSRV Funciones',
  ),
  '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' => 'es',
    '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);

?>
<div id="function.sqlsrv-execute" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">sqlsrv_execute</h1>
  <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">sqlsrv_execute</span> &mdash; <span class="dc-title">Ejecuta una sentencia preparada con <span class="function"><a href="function.sqlsrv-prepare.php" class="function">sqlsrv_prepare()</a></span></span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.sqlsrv-execute-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>sqlsrv_execute</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$stmt</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="simpara">
   Ejecuta una sentencia preparada con  <span class="function"><a href="function.sqlsrv-prepare.php" class="function">sqlsrv_prepare()</a></span>. Esta
   función es ideal para ser ejecutar múltiples veces una sentencia preparada
   con diferentes valores de parámetros.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.sqlsrv-execute-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">stmt</code></dt>
    <dd>
     <span class="simpara">
      Un recurso de sentencia devuelto por <span class="function"><a href="function.sqlsrv-prepare.php" class="function">sqlsrv_prepare()</a></span>.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.sqlsrv-execute-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.sqlsrv-execute-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 ejemplo de <span class="function"><strong>sqlsrv_execute()</strong></span></strong></p>
   <div class="example-contents"><p>
   Este ejemplo muestra como preparar una sentencia con
   <span class="function"><a href="function.sqlsrv-prepare.php" class="function">sqlsrv_prepare()</a></span> y reejecutarla múltiples veces (con
   diferentes valores de parámetros) utilizando <span class="function"><strong>sqlsrv_execute()</strong></span>.
   </p></div>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$serverName </span><span style="color: #007700">= </span><span style="color: #DD0000">"serverName\sqlexpress"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$connectionInfo </span><span style="color: #007700">= array( </span><span style="color: #DD0000">"Database"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"dbName"</span><span style="color: #007700">, </span><span style="color: #DD0000">"UID"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"username"</span><span style="color: #007700">, </span><span style="color: #DD0000">"PWD"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"password"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_connect</span><span style="color: #007700">( </span><span style="color: #0000BB">$serverName</span><span style="color: #007700">, </span><span style="color: #0000BB">$connectionInfo</span><span style="color: #007700">);<br />if( </span><span style="color: #0000BB">$conn </span><span style="color: #007700">=== </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br />    die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #0000BB">$sql </span><span style="color: #007700">= </span><span style="color: #DD0000">"UPDATE Table_1<br />        SET OrderQty = ?<br />        WHERE SalesOrderID = ?"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// Inicializar los parámetros y preparar la sentencia.<br />// Las variables $qty y $id se pasan como parámetro a la sentencia $stmt.<br /></span><span style="color: #0000BB">$qty </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$id </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_prepare</span><span style="color: #007700">( </span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$sql</span><span style="color: #007700">, array( &amp;</span><span style="color: #0000BB">$qty</span><span style="color: #007700">, &amp;</span><span style="color: #0000BB">$id</span><span style="color: #007700">));<br />if( !</span><span style="color: #0000BB">$stmt </span><span style="color: #007700">) {<br />    die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #FF8000">// Configurar la información de SalesOrderDetailID y OrderQty.<br />// Este array liga el orden ID al orden de cantidad en las parejas  key=&gt;value.<br /></span><span style="color: #0000BB">$orders </span><span style="color: #007700">= array( </span><span style="color: #0000BB">1</span><span style="color: #007700">=&gt;</span><span style="color: #0000BB">10</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">=&gt;</span><span style="color: #0000BB">20</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">=&gt;</span><span style="color: #0000BB">30</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// Ejecuta la sentencia para cada orden.<br /></span><span style="color: #007700">foreach( </span><span style="color: #0000BB">$orders </span><span style="color: #007700">as </span><span style="color: #0000BB">$id </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$qty</span><span style="color: #007700">) {<br />    </span><span style="color: #FF8000">// Como $id y $qty se pasan como parámetro a $stmt1, sus valores<br />    // actualizados se utilizan en cada ejecución de la sentencia.<br />    </span><span style="color: #007700">if( </span><span style="color: #0000BB">sqlsrv_execute</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt </span><span style="color: #007700">) === </span><span style="color: #0000BB">false </span><span style="color: #007700">) {<br />          die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />    }<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 notes" id="refsect1-function.sqlsrv-execute-notes">
  <h3 class="title">Notas</h3>
  <p class="simpara">
   Cuando se prepara una sentencia que utiliza variables como parámetros, las variables
   se pasan como parámetros a la sentencia. Esto significa que si se actualizan los valores de las
   variables, la próxima vez que se ejecute la sentencia lo hará con los nuevos valores
   de los parámetros. Para las sentencias que se quieran ejecutar únicamente una vez, utilizar
   <span class="function"><a href="function.sqlsrv-query.php" class="function">sqlsrv_query()</a></span>.
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.sqlsrv-execute-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.sqlsrv-prepare.php" class="function" rel="rdfs-seeAlso">sqlsrv_prepare()</a> - Prepara una consulta para su ejecuci&oacute;n</span></li>
   <li><span class="function"><a href="function.sqlsrv-query.php" class="function" rel="rdfs-seeAlso">sqlsrv_query()</a> - Prepara y ejecuta una consulta</span></li>
  </ul>
 </div>

</div><?php manual_footer($setup); ?>