轉換中的 XPathNavigator

XPathNavigator 類別可提供資料的唯讀隨機存取，並可當作可延伸樣式表語言轉換 (XSLT) 的輸入。它可實作於 XPathDocument、XmlDataDocument 及 XmlDocument。XPathNavigator 以 XML 路徑語言 (XPath) 之建議事項第 5 節中所說明的全球資訊網協會 (W3C) 資料模型為基礎。

XPathNavigator 可定義任何存放區上的資料指標模型，並可針對任何資料存放區提供快速、唯讀的 XPath 查詢。XPathNavigator 也是可用來重複 Result Tree Fragment 的類別。

此 API 讓您能夠從存放區目前的節點中取得資訊，並移至連接的節點上。XPathNavigator 是一種資料指標樣式模型，可使用一組 Move 方法執行存放區間的往返作業。XPathNavigator 一律定位於節點上。若 Move 方法失敗，XPathNavigator 將不會有任何變更。

XPathNavigator 是可用來重複 Result Tree Fragment 的類別。下列程式碼範例將藉由呼叫附有 fragment 參數的函式，在樣式表中建立 Result Tree Fragment。

test.xsl

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

<xsl:variable name="fragment">
    <authorlist>
       <author>Joe</author>
    </authorlist>
</xsl:variable>

<msxsl:script language="C#" implements-prefix="user">
<![CDATA[
   string NodeFragment(XPathNavigator nav)
   {
      if (nav.HasChildren)
        return nav.Value;
      else
        return "";
   }
]]>
</msxsl:script>

<xsl:template match="/">
     <xsl:value-of select="user:NodeFragment($fragment)"/>
</xsl:template>

</xsl:stylesheet>

test.xml

<root>Some text</root>

下列程式碼使用 test.xsl 樣式表和 test.xml 輸入資料。

Imports System
Imports System.IO
Imports System.Xml
Imports System.Xml.Xsl
Imports System.Xml.XPath
Imports System.Text
Public Class sample

    Public Shared Sub Main()
        Dim xslt As New XslTransform()
        xslt.Load("test.xsl")

        Dim xd As New XPathDocument("test.xml")

        Dim strmTemp = New FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite)
        xslt.Transform(xd, Nothing, strmTemp, Nothing)
    End Sub 'Main
End Class 'sample

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

public class sample
{
    public static void Main()
    {
        XslTransform xslt = new XslTransform();
        xslt.Load("test.xsl");

        XPathDocument xd = new XPathDocument("test.xml");

        Stream strmTemp = new FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite);
        xslt.Transform(xd, null, strmTemp, null);
    }
}

輸出

轉換結果儲存在檔案 out.xml 內：

<?xml version="1.0" encoding="utf-8"?>Joe

請參閱

概念

XslTransform 類別實作 XSLT 處理器