четверг, 14 апреля 2011 г.

Как использовать свои функции написанные на C# в XSLT?


Часто возникает необходимость использовать различные свои функции внутри XSLT кода.

Как же это сделать?

Очень просто!
1. Создаете новый проект, тип проекта dll-библиотека;
2. Создаете любой класс к примеру
namespace alfa.Umbraco
{
    public class Helper
    {

    }
}

3. Добавим статическую функцию:
namespace alfa.Umbraco
{
    public class Helper
    {
        public static string GetVersion()
        {
            return "1.0";
        }
    }
}

4. Компилируем библиотеку, в моем случае получился файл alfa.Umbraco.dll и копируем его в папку /bin/ на сервере где установлено Umbraco в моем случае эта папка: C:\inetpub\umbraco\bin\;
5. Далее находим файл xsltExtensions.config, он находится в папке /config/. И добавляем туда строку:
<?xml version="1.0" encoding="utf-8" ?>
<XsltExtensions>
  <!--
  This file is used to register 3rt party xslt extensions (methods you can execute from xslt, like umbraco.library:NiceUrl)
 <ext assembly="assemblyName" type="assemblyName.namespace.type" alias="custom">
  -->
 <ext assembly="alfa.Umbraco" type="alfa.Umbraco.Helper" alias="alfa.Helper"/>
</XsltExtensions>

6. Открываем наш XSLT файл в Umbraco и добавляем туда еще несколько строк. В секцию
<xsl:stylesheet ... > добавляем атрибут xmlns:alfa.Helper="urn:alfa.Helper", получается примерно вот такая конструкция:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xsl:stylesheet [ <!ENTITY nbsp "&#x00A0;"> ]>
<xsl:stylesheet 
  version="1.0" 
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
  xmlns:msxml="urn:schemas-microsoft-com:xslt" 
  xmlns:umbraco.library="urn:umbraco.library" 
  xmlns:alfa.Helper="urn:alfa.Helper" 
xmlns:Exslt.ExsltCommon="urn:Exslt.ExsltCommon" 
xmlns:Exslt.ExsltDatesAndTimes="urn:Exslt.ExsltDatesAndTimes" 
xmlns:Exslt.ExsltMath="urn:Exslt.ExsltMath" 
xmlns:Exslt.ExsltRegularExpressions="urn:Exslt.ExsltRegularExpressions" 
xmlns:Exslt.ExsltStrings="urn:Exslt.ExsltStrings" 
xmlns:Exslt.ExsltSets="urn:Exslt.ExsltSets" 
  exclude-result-prefixes="alfa.Helper msxml umbraco.library Exslt.ExsltCommon Exslt.ExsltDatesAndTimes Exslt.ExsltMath Exslt.ExsltRegularExpressions Exslt.ExsltStrings Exslt.ExsltSets ">

<xsl:output method="xml" omit-xml-declaration="yes" />

<xsl:param name="currentPage"/>

<xsl:template match="/">
</xsl:template>

</xsl:stylesheet>

7. А теперь вызовем нашу функцию:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xsl:stylesheet [ <!ENTITY nbsp "&#x00A0;"> ]>
<xsl:stylesheet 
  version="1.0" 
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
  xmlns:msxml="urn:schemas-microsoft-com:xslt" 
  xmlns:umbraco.library="urn:umbraco.library" 
  xmlns:alfa.Helper="urn:alfa.Helper" 
xmlns:Exslt.ExsltCommon="urn:Exslt.ExsltCommon" 
xmlns:Exslt.ExsltDatesAndTimes="urn:Exslt.ExsltDatesAndTimes" 
xmlns:Exslt.ExsltMath="urn:Exslt.ExsltMath" 
xmlns:Exslt.ExsltRegularExpressions="urn:Exslt.ExsltRegularExpressions" 
xmlns:Exslt.ExsltStrings="urn:Exslt.ExsltStrings" 
xmlns:Exslt.ExsltSets="urn:Exslt.ExsltSets" 
  exclude-result-prefixes="alfa.Helper msxml umbraco.library Exslt.ExsltCommon Exslt.ExsltDatesAndTimes Exslt.ExsltMath Exslt.ExsltRegularExpressions Exslt.ExsltStrings Exslt.ExsltSets ">

<xsl:output method="xml" omit-xml-declaration="yes" />

<xsl:param name="currentPage"/>

<xsl:template match="/">
<xsl:value-of select="alfa.Helper:GetVersion()"/>
</xsl:template> </xsl:stylesheet>


Готово!


Комментариев нет:

Отправить комментарий