Blocchi di script utilizzando msxsl:script
Nota
I blocchi di script sono supportati solo in .NET Framework. Non sono supportati in .NET Core o .NET 5 o versioni successive.
La classe XslCompiledTransform supporta lo script incorporato mediante l'elemento msxsl:script. Quando viene caricato il foglio di stile, le funzioni definite vengono compilate in MSIL (Microsoft Intermediate Language) da CodeDOM (Code Document Object Model) e vengono attivate in fase di esecuzione. L'assembly generato dal blocco di script incorporato è separato rispetto all'assembly generato per il foglio di stile.
Abilitazione di script XSLT
Il supporto per gli script incorporati è un'impostazione XSLT facoltativa nella classe XslCompiledTransform. Per impostazione predefinita, il supporto per gli script è disabilitato. Per abilitarlo, è necessario creare un oggetto XsltSettings con la proprietà EnableScript impostata su true e passare tale oggetto al metodo Load.
Nota
Lo script con XSLT deve essere abilitato solo se è necessario il supporto per gli script e solo all'interno di un ambiente completamente attendibile.
Definizione dell'elemento msxsl:script
L'elemento msxsl:script è un'estensione Microsoft della raccomandazione XSLT 1.0 e presenta la seguente definizione:
<msxsl:script language = "language-name" implements-prefix = "prefix of user namespace"> </msxsl:script>
Il prefisso msxsl è associato all'URI dello spazio dei nomi urn:schemas-microsoft-com:xslt. Nel foglio di stile XSLT deve essere inclusa la dichiarazione dello spazio dei nomi xmlns:msxsl=urn:schemas-microsoft-com:xslt.
L'attributo language è facoltativo. Il valore dell'attributo è il linguaggio di codice del blocco di codice incorporato. Il linguaggio è associato al compilatore CodeDOM appropriato tramite il metodo CodeDomProvider.CreateProvider. La classe XslCompiledTransform può supportare qualsiasi linguaggio Microsoft .NET, a condizione che il provider appropriato sia installato nel computer e sia registrato nella sezione system.codedom del file machine.config. Se non viene specificato un attributo language, verrà impostato il valore predefinito JScript. Poiché nel nome del linguaggio non viene rilevata la differenza tra maiuscole e minuscole, 'JavaScript' e 'javascript' sono equivalenti.
L'attributo implements-prefix è obbligatorio. Questo attributo viene usato per dichiarare uno spazio dei nomi e associarlo al blocco di script. Il valore di questo attributo è il prefisso che rappresenta lo spazio dei nomi. È possibile definire questo prefisso in un punto qualsiasi di un foglio di stile.
Nota
Quando si usa l'elemento msxsl:script, si consiglia che tale script, indipendentemente dal linguaggio, venga inserito all'interno di una sezione CDATA. Dal momento che può contenere operatori, identificatori o delimitatori per un determinato linguaggio, se non è contenuto in una sezione CDATA, è possibile che lo script venga erroneamente interpretato come XML. Nel seguente XML viene illustrato un modello di sezione CDATA in cui può essere inserito il codice.
<msxsl:script implements-prefix='your-prefix' language='CSharp'>
<![CDATA[
// Code block.
]]>
</msxsl:script>
Funzioni di script
È possibile dichiarare le funzioni all'interno dell'elemento msxsl:script. Quando si dichiara una funzione, questa è contenuta in un blocco di script. I fogli di stile possono contenere più blocchi di script con funzionamento indipendente l'uno dall'altro. Ciò significa che, all'interno di un blocco di script, non è possibile chiamare una funzione definita in un altro blocco di script a meno che per quest'ultimo non sia dichiarato lo stesso spazio dei nomi e lo stesso linguaggio di script. Poiché ogni blocco di script può essere scritto nel proprio linguaggio e il blocco viene analizzato in base alle regole grammaticali del parser di quel linguaggio, si consiglia di usare la sintassi corretta per il linguaggio in uso. Ad esempio, nel caso di un blocco di script di Microsoft C#, si consiglia di usare la sintassi di commento di C#.
Gli argomenti e i valori restituiti che vengono forniti alla funzione possono essere di qualsiasi tipo. Poiché i tipi W3C XPath sono subset dei tipi CLR (Common Language Runtime), la conversione del tipo viene eseguita per i tipi che non sono considerati come tipi XPath. Nella tabella seguente vengono illustrati i tipi W3C corrispondenti e il tipo CLR equivalente.
| Tipo W3C | Tipo CLR |
|---|---|
String |
String |
Boolean |
Boolean |
Number |
Double |
Result Tree Fragment |
XPathNavigator |
Node Set |
XPathNodeIterator |
I tipi numerici CLR vengono convertiti nel tipo Double. Il tipo DateTime viene convertito in String e i tipi IXPathNavigable in XPathNavigator. XPathNavigator[] viene convertito nel tipo XPathNodeIterator.
Per tutti gli altri tipi verrà generato un errore.
Importazione di spazi dei nomi e assembly
La classe XslCompiledTransform contiene un set predefinito di assembly e di spazi dei nomi che è supportato per impostazione predefinita dall'elemento msxsl:script. Tuttavia, è possibile usare le classi e i membri appartenenti a uno spazio dei nomi che non è presente nell'elenco predefinito importando l'assembly e lo spazio dei nomi nel blocco msxsl:script.
Assembly
Per impostazione predefinita, viene fatto riferimento ai due assembly seguenti:
System.dll
System.Xml.dll
Microsoft.VisualBasic.dll (se il linguaggio di script è VB)
È possibile importare ulteriori assembly usando l'elemento msxsl:assembly, incluso l'assembly quando il foglio di stile è compilato. L'elemento msxsl:assembly presenta la seguente definizione:
<msxsl:script>
<msxsl:assembly name="system.assemblyName" />
<msxsl:assembly href="path-name" />
<![CDATA[
// User code
]]>
</msxsl:script>
L'attributo name contiene il nome dell'assembly, mentre l'attributo href ne contiene il percorso. Il nome dell'assembly può essere un nome completo, ad esempio "System.Data, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089", oppure un nome breve, ad esempio "System.Web".
Namespaces (Spazi dei nomi)
Per impostazione predefinita sono inclusi i seguenti spazi dei nomi:
Sistema
System.Collection
System.Text
System.Text.RegularExpressions
System.Xml
System.Xml.Xsl
System.Xml.XPath
Microsoft.VisualBasic (se il linguaggio di script è VB)
È possibile aggiungere il supporto per ulteriori spazi di nomi usando l'attributo namespace. Il valore dell'attributo è il nome dello spazio dei nomi.
<msxsl:script>
<msxsl:using namespace="system.namespaceName" />
<![CDATA[
// User code
]]>
</msxsl:script>
Esempio
Nell'esempio seguente viene usato uno script incorporato per calcolare la circonferenza di un cerchio di cui viene fornito il raggio.
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() {
// Compile the style sheet.
XsltSettings xslt_settings = new XsltSettings();
xslt_settings.EnableScript = true;
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(stylesheet, xslt_settings, new XmlUrlResolver());
// Load the XML source file.
XPathDocument doc = new XPathDocument(filename);
// Create an XmlWriter.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.Indent = true;
XmlWriter writer = XmlWriter.Create("output.xml", settings);
// Execute the transformation.
xslt.Transform(doc, writer);
writer.Close();
}
}
Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Xml.Xsl
Public class Sample
Private Const filename As String = "number.xml"
Private Const stylesheet As String = "calc.xsl"
Public Shared Sub Main()
' Compile the style sheet.
Dim xslt_settings As XsltSettings = New XsltSettings()
xslt_settings.EnableScript = true
Dim xslt As XslCompiledTransform = New XslCompiledTransform()
xslt.Load(stylesheet, xslt_settings, New XmlUrlResolver())
' Load the XML source file.
Dim doc As XPathDocument = New XPathDocument(filename)
' Create an XmlWriter.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.Indent = true
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
' Execute the transformation.
xslt.Transform(doc, writer)
writer.Close()
End Sub
End Class
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>
Output
<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>
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per