Aracılığıyla paylaş

XslTransformation görevi

  • Makale

XSLT veya derlenmiş XSLT kullanarak XML girişini dönüştürür ve çıkış cihazını veya dosyayı verir.

Parametreler

Aşağıdaki tabloda görevin parametreleri XslTransformation açıklanmaktadır.

Parametre Açıklama
OutputPaths Gerekli ITaskItem[] parametresi.

XML dönüşümü için çıkış dosyalarını belirtir.
Parameters İsteğe bağlı String parametre.

XSLT Giriş belgesinin parametrelerini belirtir. Her parametreyi olarak <Parameter Name="" Value="" Namespace="" />tutan ham XML'yi sağlayın.
UseTrustedSettings İsteğe bağlı boole parametresi.

ise True, XSLT işlevinin ve ekli betiklerin kullanımına izin veren rahat XSLT document() güvenlik ayarlarını etkinleştirir. Bkz. TrustedXslt. İlgili güvenlik konuları için bkz . Güvenlikle ilgili dikkat edilmesi gerekenler.
XmlContent İsteğe bağlı String parametre.

XML girişini dize olarak belirtir.
XmlInputPaths İsteğe bağlı ITaskItem[] parametre.

XML giriş dosyalarını belirtir.
XslCompiledDllPath İsteğe bağlı ITaskItem parametre.

Derlenmiş XSLT'yi belirtir.
XslContent İsteğe bağlı String parametre.

Dize olarak XSLT girişini belirtir.
XslInputPath İsteğe bağlı ITaskItem parametre.

XSLT giriş dosyasını belirtir.

Açıklamalar

Önemli

XSLT stil sayfaları, diğer dosyalara ve ekli betik bloklarına başvurular içerebilir. Kötü amaçlı bir kullanıcı, yürütüldüğünde bilgisayarınızın kaynakları yetersiz olana kadar sisteminizin işlemesine neden olabilecek veri veya stil sayfaları sağlayarak bu durumdan yararlanabilir. Stil sayfası güvenilir bir kaynaktan gelmediği sürece aracılığıyla betik oluşturmayı veya document() işlevini UseTrustedSettings etkinleştirmeyin. Stil sayfasının kaynağını doğrulayamıyorsanız veya stil sayfası güvenilir bir kaynaktan gelmiyorsa varsayılan XSLT ayarlarını kullanın.

Ayrıca şemalar gibi dış kaynakların yüklenmesinin, şema barındıran tüm sunucuların bir derleme oluşumunu ve ağ konumunu bulmasına izin verileceğini unutmayın.

Tabloda listelenen parametrelerin bulunmasına ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki örnekte xml dosyasını değiştirmek için transform.xslt bir XSL dönüşüm dosyası $(XmlInputFileName)kullanılmıştır. Dönüştürülen XML öğesine $(IntermediateOutputPath)output.xmlyazılır. XSL dönüşümü giriş parametresi olarak alır $(Parameter1) .

    <XslTransformation XslInputPath="transform.xslt"
                       XmlInputPaths="$(XmlInputFileName)"
                       OutputPaths="$(IntermediateOutputPath)output.xml"
                       Parameters="&lt;Parameter Name='Parameter1' Value='$(Parameter1)'/&gt;"/>

Ayrıca bkz.