Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

Escribir scripts de hojas de estilos XSLT mediante <msxsl:script>

 

Esta clase XslTransform admite scripts incrustados mediante el elemento script.

System_CAPS_noteNota

La clase XslTransform es obsoleta en .NET Framework 2.0. Puede llevar a cabo Extensible Stylesheet Language for Transformations (XSLT) mediante la clase XslCompiledTransform. Para obtener más información, vea Uso de la clase XslCompiledTransform y Migración desde la clase XslTransform.

Esta clase XslTransform admite scripts incrustados mediante el elemento script. Cuando se carga la hoja de estilos, las funciones definidas se compilan en el lenguaje intermedio de Microsoft (MSIL) ya que se incluyen en una definición de clase y no se produce pérdida alguna de rendimiento.

A continuación se define el elemento <msxsl:script>:

<msxsl:script language = "language-name" implements-prefix = "prefix of user namespace"> </msxsl:script>

donde msxsl es un prefijo enlazado al espacio de nombres urn:schemas-microsoft-com:xslt.

El atributo language no es obligatorio, pero si se especifica, su valor deberá ser uno de los siguientes: C#, VB, JScript, JavaScript, VisualBasic o CSharp. Si no se especifica, el lenguaje predeterminado es JScript. language-name no distingue entre mayúsculas y minúsculas, entonces 'JavaScript' y 'javascript' son equivalentes.

El atributo implements-prefix es obligatorio. Este atributo se utiliza para declarar un espacio de nombres y asociarlo con el bloque del script. El valor de este atributo es el prefijo que representa el espacio de nombres. Este espacio de nombres puede definirse en cualquier parte de la hoja de estilos.

Puesto que el elemento msxsl:script pertenece al espacio de nombres urn:schemas-microsoft-com:xslt, la hoja de estilos debe incluir la declaración del espacio de nombres xmlns:msxsl=urn:schemas-microsoft-com:xslt.

Si el llamador del script no tiene permiso de acceso a UnmanagedCode, el script de una hoja de estilos no se compilará y la llamada a Load producirá errores.

Si el llamador tiene permiso UnmanagedCode, el script se compilará, pero las operaciones permitidas dependen de la evidencia suministrada en tiempo de carga.

Si utiliza uno de los métodos Load que toman XmlReader o XPathNavigator para cargar la hoja de estilos, tendrá que utilizar la sobrecarga Load que toma un parámetro Evidence como uno de sus argumentos. Para proporcionar evidencia, el llamador debe tener permiso ControlEvidence para suministrar Evidence al ensamblado de scripts. Si el llamador no dispone de este permiso, puede establecer el parámetro Evidence en null. Esto hace que la función Load produzca errores si encuentra el script. Se considera que el permiso ControlEvidence es un permiso muy eficaz que solo debería garantizarse al código de plena confianza.

Para obtener la evidencia desde el ensamblado, utilice this.GetType().Assembly.Evidence. Para obtener evidencia de un identificador de recurso uniforme (URI), utilice Evidence e = XmlSecureResolver.CreateEvidenceForUrl(stylesheetURI).

Si utiliza métodos Load que toman XmlResolver pero no Evidence, la zona de seguridad del ensamblado toma como valor predeterminado Plena confianza. Para más información, vea SecurityZone y Conjuntos de permisos con nombre.

Las funciones se pueden declarar dentro del elemento msxsl:script. La tabla siguiente muestra los espacios de nombres que se admiten de forma predeterminada. Es posible utilizar clases fuera de los espacios de nombres enumerados. Sin embargo, el nombre de las clases debe estar completo.

Espacios de nombres predeterminados

Descripción

System

Clase del sistema.

System.Collection

Clases de colección

System.Text

Clases de texto.

System.Text.RegularExpressions

Clases de expresión regular.

System.Xml

Clases XML básicas

System.Xml.Xsl

Clases XSLT

System.Xml.Xpath

Clases XML Path Language (XPath).

Microsoft.VisualBasic

Clases para scripts de Visual Basic.

Cuando se declara una función, está contenida en un bloque de scripts. Las hojas de estilos pueden contener varios bloques de scripts que funcionan independientemente unos de otros. Esto significa que si se ejecuta código desde un bloque de scripts, no podrá llamar a una función definida en otro bloque a menos que se haya declarado en el mismo espacio de nombres y con el mismo lenguaje de scripts. Puesto que cada bloque de script puede estar en su propio lenguaje, y el bloque se analiza de acuerdo con las reglas de gramática de dicho analizador de lenguaje, deberá utilizar la sintaxis correcta para el lenguaje que esté siendo utilizado. Por ejemplo, en un bloque de scripts de C#, es erróneo utilizar un nodo de comentario de XML <!-- an XML comment -->.

Los argumentos proporcionados y los valores devueltos definidos en las funciones del script deben ser de los tipos XPath o XSLT del W3C. En la siguiente tabla se muestran los tipos correspondientes del W3C, las clases de .NET Framework equivalentes (tipo) y si el tipo del W3C es un tipo de XPath o un tipo de XSLT.

Tipo

Clase equivalente .NET Framework (tipo)

Tipo de XPath o tipo XSLT

String

System.String

XPath

Boolean

System.Boolean

XPath

Número

System.Double

XPath

Fragmento del árbol de resultados

System.Xml.XPath.XPathNavigator

XSLT

Conjunto de nodos

System.Xml.XPath.XPathNodeIterator

XPath

Si la función de script utiliza uno de los siguientes tipos numéricos: Int16, UInt16, Int32, UInt32, Int64, UInt64, Single o Decimal, se convierten obligatoriamente en Double, que se asigna al número de tipo W3C XPath. El resto de los tipos se convierten obligatoriamente en tipos String con el método ToString.

Si la función del script utiliza un tipo distinto a los mencionados anteriormente o si no se compila al cargar la hoja de estilos en el objeto XslTransform, se inicia una excepción.

Al utilizar el elemento msxsl:script se recomienda encarecidamente que el script, independientemente del lenguaje, se coloque dentro de una sección CDATA. Por ejemplo, en el código XML siguiente se muestra la plantilla de la sección CDATA donde se coloca el código.

<msxsl:script implements-prefix='yourprefix' language='CSharp'>
    <![CDATA[
    ... your code here ...
    ]]>
</msxsl:script>

Se recomienda encarecidamente que todo el contenido de scripts se coloque en una sección CDATA porque existe la posibilidad de que los operadores, identificadores o delimitadores de un lenguaje determinado se interpreten erróneamente como XML. En el ejemplo siguiente se demuestra el uso del operador lógico AND en un script.

<msxsl:script implements-prefix='yourprefix' language='CSharp>
    public string book(string abc, string xyz)
    {  if ((abc== abc)&&(abc== xyz)) return bar+xyz;
        else return null;
    }
</msxsl:script>

De esta forma se inicia una excepción debido a que no se establece una secuencia de escape para el carácter Y comercial (&amp;). Este documento se carga como XML y no se aplica un tratamiento especial al texto que hay entre las etiquetas del elemento msxsl:script.

En el ejemplo siguiente se utiliza un script incrustado para calcular la longitud de una circunferencia dado su radio.

using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Xml.Xsl;

public class Sample
{
   private const String filename = "number.xml";
   private const String stylesheet = "calc.xsl";

   public static void Main() {

    //Create the XslTransform and load the style sheet.
    XslTransform xslt = new XslTransform();
    xslt.Load(stylesheet);

    //Load the XML data file.
    XPathDocument doc = new XPathDocument(filename);

    //Create an XmlTextWriter to output to the console.             
    XmlTextWriter writer = new XmlTextWriter(Console.Out);
    writer.Formatting = Formatting.Indented;

    //Transform the file.
    xslt.Transform(doc, null, writer, null);
    writer.Close();
  } 
}

number.xml

<?xml version='1.0'?>
<data>
  <circle>
    <radius>12</radius>
  </circle>
  <circle>
    <radius>37.5</radius>
  </circle>
</data>

calc.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:msxsl="urn:schemas-microsoft-com:xslt"
    xmlns:user="urn:my-scripts">

  <msxsl:script language="C#" implements-prefix="user">
     <![CDATA[
     public double circumference(double radius){
       double pi = 3.14;
       double circ = pi*radius*2;
       return circ;
     }
      ]]>
   </msxsl:script>

  <xsl:template match="data">  
  <circles>

  <xsl:for-each select="circle">
    <circle>
    <xsl:copy-of select="node()"/>
       <circumference>
          <xsl:value-of select="user:circumference(radius)"/> 
       </circumference>
    </circle>
  </xsl:for-each>
  </circles>
  </xsl:template>
</xsl:stylesheet>

<circles xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
  <circle>
    <radius>12</radius>
    <circumference>75.36</circumference>
  </circle>
  <circle>
    <radius>37.5</radius>
    <circumference>235.5</circumference>
  </circle>
</circles>  
Mostrar: