<msxsl:assembly>-Element

Deklariert Assemblys für die Verwendung in Skriptblöcken. Dieses Element ist ein untergeordnetes Element des <msxsl:script>-Elements.

<msxsl:assembly
  name = "assemblyname"
  href = "pathname"
</msxsl:assembly>

Attribute

• name
  Verweist mit dem Namen auf eine Assembly für die Verwendung innerhalb des Skriptblocks.

• href
  Verweist mit dem Dateinamen oder URI auf eine Assembly für die Verwendung innerhalb des Skriptblocks.

Elementinformationen

Anzahl der Vorkommen	Unbegrenzt
Übergeordnete Elemente	<msxsl:script>-Element

Hinweise

Hinweis:
Dieses Element wird nur in .NET Framework unterstützt.

In diesem Element muss genau eines der Attribute angegeben werden.

Mit dem name-Format des Attributs kann der Assemblydateiname in vereinfachter oder vollständiger Form angegeben werden, wie in den folgenden Beispielen veranschaulicht.

<ms:assembly name="System.Xml"/>
<ms:assembly name="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>

Mit dem href-Format des Attributs kann der Assemblyname entweder als Dateipfad oder als URI angegeben werden, wie in den folgenden Beispielen veranschaulicht.

<ms:assembly href="Helper.dll"/>
<ms:assembly href="C:\MyApplication\Helper.dll"/>
<ms:assembly href="http://tempuri.org/Helper.dll"/>

Der Assemblypfadname wird zweimal aufgelöst, einmal beim Kompilieren und einmal beim Ausführen. Die Regeln beim Kompilieren sind mit den Compilerregeln identisch. Wenn für die Assembly kein vollqualifizierter Pfad bereitgestellt wird, wird das aktuelle Verzeichnis nach der angegebenen Assembly durchsucht. Wenn die Suche fehlschlägt, wird das Systemverzeichnis der Common Language Runtime durchsucht. Wenn die Suche ergebnislos ist, werden die in der LIB-Umgebungsvariablen angegebenen Verzeichnisse durchsucht.

Während der Ausführung werden die Ladeprogrammregeln von .NET Framework verwendet. Das aktuelle Verzeichnis wird zuerst durchsucht, anschließend der globale Assemblycache und dann alle in der Konfigurationsdatei der Anwendung angegebenen Regeln.

Auf die folgenden Assemblys wird standardmäßig verwiesen:

• System.dll

• System.Xml.dll

• Microsoft.VisualBasic.dll (bei Verwendung von Visual Basic)

Beispiel

Im folgenden Beispiel wird der Zugriff auf eine Klasse in einer benutzerdefinierten Assembly mit dem Namen MyCompany.HelperAssembly veranschaulicht.

Dies ist der in der MyCompany.HelperAssembly-Assembly enthaltene C#-Code.

namespace MyCompany.XmlHelper
{
   public class NodeContents
   {
      XPathNavigator _nav;

      public NodeContents(XPathNavigator nav)
      {
         _nav = nav;
      }

      public string GetNodeContents()
      {
         return _nav.InnerXml;
      }
   }
}

Das folgende Stylesheet fügt einen Verweis auf die Assembly hinzu und importiert den entsprechenden Namespace. Auf die Klassen im Assemblynamespace wird im Skriptblock verwiesen.

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

  <msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="MyCompany.HelperAssembly" />
    <msxsl:using namespace="MyCompany.XmlHelper" />
    public string FragmentValue(XPathNavigator nav)
    {
       NodeContents myContents = new NodeContents(nav);
       return myContents.GetNodeContents();
    }
  </msxsl:script>


    <xsl:template match="/">
            <xsl:value-of select="user:FragmentValue(customer[1])"/>
    </xsl:template>
</xsl:stylesheet>