<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.com.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'class.dotnet.php',
    1 => 'dotnet',
    2 => 'La clase dotnet',
  ),
  'up' => 
  array (
    0 => 'book.com.php',
    1 => 'COM',
  ),
  'prev' => 
  array (
    0 => 'com.construct.php',
    1 => 'com::__construct',
  ),
  'next' => 
  array (
    0 => 'dotnet.construct.php',
    1 => 'dotnet::__construct',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/com/dotnet.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.dotnet.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.dotnet" class="reference">
 
 <h1 class="title">La clase dotnet</h1>
 <div class="partintro"><p class="verinfo">(PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8)</p>


  <div class="section" id="dotnet.intro">
   <h2 class="title">Introducción</h2>
   <p class="para">
    La clase dotnet permite instanciar una clase desde un ensamblado
    .NET y llamar y acceder a sus propiedades, si la clase y los métodos
    y las propiedades son
    <a href="https://docs.microsoft.com/dotnet/api/system.runtime.interopservices.comvisibleattribute" class="link external">&raquo;&nbsp;visible para COM</a>.
   </p>
   <p class="para">
    Ni la instanciación de clases estáticas ni la llamada de métodos estáticos es
    soportada.
    La instanciación de clases genéricas como
    <code class="literal">System.Collections.Generic.List</code> tampoco está soportada.
   </p>
   <p class="para">
    Algunas clases .Net no implementan IDispatch, por lo que aunque pueden ser instanciadas, llamar a métodos o acceder a propiedades en estas clases no es soportado.
   </p>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <p class="para">
     Se debe instalar el motor de ejecución .Net en el servidor web para aprovechar esta funcionalidad.
    </p>
   </p></blockquote>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <p class="para">
     Anterior a PHP 8.0.0, el framework .Net 4.0 y versiones posteriores no son soportados por la clase
     <span class="classname"><strong class="classname">dotnet</strong></span>. Si los ensamblados han sido registrados con
     <strong class="command">regasm.exe</strong>, las clases pueden ser instanciadas como objetos <span class="classname"><a href="class.com.php" class="classname">com</a></span>, sin embargo.
     A partir de PHP 8.0.0, el framework .Net 4.0 y las versiones posteriores son soportados
     a través de la directiva <var class="filename">php.ini</var> <a href="com.configuration.php#ini.com.dotnet-version" class="link">com.dotnet_version</a>.
    </p>
   </p></blockquote>
  </div>


  <div class="section" id="dotnet.synopsis">
   <h2 class="title">Sinopsis de la Clase</h2>


   <div class="classsynopsis"><div class="classsynopsisinfo">
    
     <span class="modifier">class</span> <strong class="classname"><strong class="classname">dotnet</strong></strong>
    

    
     <span class="modifier">extends</span>
      <a href="class.variant.php" class="classname">variant</a>
     {</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Métodos */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><a href="dotnet.construct.php" class="methodname">__construct</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$assembly_name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$datatype_name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$codepage</code><span class="initializer"> = <strong><code><a href="com.constants.php#constant.cp-acp">CP_ACP</a></code></strong></span></span>)</div>

   }</div>


  </div>

  <div class="section" id="class.dotnet.overloadedmethods">
   <h2 class="title">Métodos sobrecargados</h2>
   <p class="para">
    El objeto devuelto es un objeto sobrecargado, lo que significa que PHP no ve
    los métodos fijados como lo hace con las clases normales; en su lugar, todo acceso a propiedades o métodos se pasa a través de COM y desde allí a DOTNET. En otras palabras, el objeto .Net se mapea a través de la capa de interoperabilidad COM proporcionada por el motor de ejecución .Net.
   </p>
   <p class="para">
    Una vez que se ha creado un objeto dotnet, PHP lo trata de la misma manera
    que cualquier otro objeto COM; se aplican las mismas reglas.
   </p>
  </div>

  <div class="section" id="class.dotnet.examples">
   <h2 class="title">Ejemplos dotnet</h2>
   <p class="para">
    <div class="example" id="example.dotnet">
     <p><strong>Ejemplo #1 Ejemplo dotnet</strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$stack </span><span style="color: #007700">= new </span><span style="color: #0000BB">dotnet</span><span style="color: #007700">(</span><span style="color: #DD0000">"mscorlib"</span><span style="color: #007700">, </span><span style="color: #DD0000">"System.Collections.Stack"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$stack</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">Push</span><span style="color: #007700">(</span><span style="color: #DD0000">".Net"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$stack</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">Push</span><span style="color: #007700">(</span><span style="color: #DD0000">"Hello "</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$stack</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">Pop</span><span style="color: #007700">() . </span><span style="color: #0000BB">$stack</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">Pop</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>

 </div>

 






<h2>Tabla de contenidos</h2><ul class="chunklist chunklist_reference"><li><a href="dotnet.construct.php">dotnet::__construct</a> — Constructor de la clase dotnet</li></ul>
</div>
<?php manual_footer($setup); ?>