<?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-get-field.php',
    1 => 'sqlsrv_get_field',
    2 => 'Recupera los datos del campo desde la l&iacute;nea actualmente seleccionada',
  ),
  'up' => 
  array (
    0 => 'ref.sqlsrv.php',
    1 => 'SQLSRV Funciones',
  ),
  'prev' => 
  array (
    0 => 'function.sqlsrv-get-config.php',
    1 => 'sqlsrv_get_config',
  ),
  'next' => 
  array (
    0 => 'function.sqlsrv-has-rows.php',
    1 => 'sqlsrv_has_rows',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/sqlsrv/functions/sqlsrv-get-field.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.sqlsrv-get-field" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">sqlsrv_get_field</h1>
  <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">sqlsrv_get_field</span> &mdash; <span class="dc-title">Recupera los datos del campo desde la línea actualmente seleccionada</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.sqlsrv-get-field-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>sqlsrv_get_field</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="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$fieldIndex</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$getAsType</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

  <p class="simpara">
   Recupera los datos del campo desde la línea actualmente seleccionada.
   Los campos deben ser leídos en orden. Sus índices comienzan en 0.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.sqlsrv-get-field-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">stmt</code></dt>
    <dd>
     <span class="simpara">
      Un recurso de consulta devuelto por la función
      <span class="function"><a href="function.sqlsrv-query.php" class="function">sqlsrv_query()</a></span> o la función
      <span class="function"><a href="function.sqlsrv-execute.php" class="function">sqlsrv_execute()</a></span>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">fieldIndex</code></dt>
    <dd>
     <span class="simpara">
      El índice del campo a recuperar. Los índices de los campos comienzan en 0.
      Los campos deben ser leídos en orden, es decir, si se accede al campo
      con índice 1, el campo con índice 0 ya no estará disponible.
     </span>
    </dd>
   
   
    <dt><code class="parameter">getAsType</code></dt>
    <dd>
     <span class="simpara">
      El tipo de datos PHP para los datos del campo devuelto. Si este argumento
      no está definido, los datos del campo serán devueltos en forma de un tipo de datos PHP por omisión. Para más información sobre los
      tipos de datos PHP por omisión, consulte la sección sobre
      <a href="http://msdn.microsoft.com/en-us/library/cc296193.aspx" class="link external">&raquo;&nbsp;los tipos de datos PHP por omisión</a>
      de la documentación Microsoft SQLSRV.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.sqlsrv-get-field-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Devuelve los datos desde el campo especificado en caso de éxito.
   Devuelve <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-get-field-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 <span class="function"><strong>sqlsrv_get_field()</strong></span> example</strong></p>
   <div class="example-contents"><p>
    El siguiente ejemplo muestra cómo recuperar una línea con la
    función <span class="function"><a href="function.sqlsrv-fetch.php" class="function">sqlsrv_fetch()</a></span> y recupera
    los campos de la línea con la función <span class="function"><strong>sqlsrv_get_field()</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">"SELECT Name, Comment<br />        FROM Table_1<br />        WHERE ReviewID=1"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_query</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">);<br />if( </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: #FF8000">// Hace disponible la primera (y en este caso, la única) línea del conjunto de resultados para lectura.<br /></span><span style="color: #007700">if( </span><span style="color: #0000BB">sqlsrv_fetch</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: #FF8000">// Recupera los campos de la línea. Los índices comienzan en 0 y deben ser recuperados en orden.<br />// La recuperación de los campos de la línea por sus nombres no es soportada por la función sqlsrv_get_field.<br /></span><span style="color: #0000BB">$name </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_get_field</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">);<br />echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">: "</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$comment </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_get_field</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$comment</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.sqlsrv-get-field-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.sqlsrv-fetch.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch()</a> - Hace que est&eacute; disponible para ser le&iacute;da la siguiente fila del conjunto de resultado</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-array.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_array()</a> - Devuelve una fila como un array</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-object.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_object()</a> - Devuelve la siguiente fila de datos de un conjunto resultado como un objeto</span></li>
  </ul>
 </div>

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