XmlNode.CreateNavigator メソッド

.NET Framework クラス ライブラリ リファレンス

XmlNode.CreateNavigator メソッド

このオブジェクト内を移動するための XPathNavigator を作成します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 CreateNavigator As XPathNavigator

Visual Basic (使用法)

Dim instance As XmlNode
Dim returnValue As XPathNavigator

returnValue = instance.CreateNavigator

C#

public virtual XPathNavigator CreateNavigator ()

C++

public:
virtual XPathNavigator^ CreateNavigator ()

J#

public XPathNavigator CreateNavigator ()

JScript

public function CreateNavigator () : XPathNavigator

戻り値
XPathNavigator オブジェクト。XPathNavigator は、メソッドの呼び出し元のノードに配置されます。ドキュメントのルートには配置されません。

解説

XPathNavigator は、データへの読み取り専用のランダム アクセスを提供します。XSLT 変換用に最適化されているため、XslTransform.Transform メソッドへの入力機構として使用すると、パフォーマンスが向上します。

このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。

使用例

XSLT 変換を実行する前に XML ドキュメントを読み込み、編集する例を次に示します。

Visual Basic

Dim doc as XmlDocument = new
 XmlDocument()
doc.Load("books.xml")

' Modify the XML file.
Dim root as XmlElement = doc.DocumentElement
root.FirstChild.LastChild.InnerText = "12.95"

' Create an XPathNavigator to use for the transform.
Dim nav as XPathNavigator = root.CreateNavigator()

' Transform the file.
Dim xslt as XslTransform = new
 XslTransform()
xslt.Load("output.xsl")
Dim writer as XmlTextWriter = new
 XmlTextWriter("books.html", nothing)
xslt.Transform(nav,nothing, writer, nothing)

C#

XmlDocument doc = new XmlDocument();
doc.Load("books.xml");

// Modify the XML file.
XmlElement root = doc.DocumentElement;
root.FirstChild.LastChild.InnerText = "12.95";

// Create an XPathNavigator to use for the transform.
XPathNavigator nav = root.CreateNavigator();

// Transform the file.
XslTransform xslt = new XslTransform();
xslt.Load("output.xsl");
XmlTextWriter writer = new XmlTextWriter("books.html",
 null);
xslt.Transform(nav, null, writer, null);

C++

XmlDocument^ doc = gcnew XmlDocument;
doc->Load( "books.xml" );

// Modify the XML file.
XmlElement^ root = doc->DocumentElement;
root->FirstChild->LastChild->InnerText = "12.95";

// Create an XPathNavigator to use for the transform.
XPathNavigator^ nav = root->CreateNavigator();

// Transform the file.
XslTransform^ xslt = gcnew XslTransform;
xslt->Load( "output.xsl" );
XmlTextWriter^ writer = gcnew XmlTextWriter( "books.html", nullptr );
xslt->Transform( nav, nullptr, writer, nullptr);

J#

XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
// Modify the XML file.
XmlElement root = doc.get_DocumentElement();
root.get_FirstChild().get_LastChild().set_InnerText("12.95");
// Create an XPathNavigator to use for the transform.
XPathNavigator nav = root.CreateNavigator();
// Transform the file.
XslTransform xslt = new XslTransform();
xslt.Load("output.xsl");
XmlTextWriter writer = new XmlTextWriter("books.html",
 null);
xslt.Transform(nav, null, writer, null);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
XmlNode クラス
XmlNode メンバ
System.Xml 名前空間
XslTransform