XPathDocument

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

XPathDocument クラス

XPath データ モデルを使用して、XML ドキュメントの読み取り専用で高速なインメモリ表現を提供します。

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

Visual Basic (宣言)

Public Class XPathDocument
    Implements IXPathNavigable

Visual Basic (使用法)

Dim instance As XPathDocument

C#

public class XPathDocument : IXPathNavigable

C++

public ref class XPathDocument : IXPathNavigable

J#

public class XPathDocument implements IXPathNavigable

JScript

public class XPathDocument implements IXPathNavigable

解説

XPath データ モデルを使用した XML データの処理の詳細については、「XPath データ モデルを使用した XML データの処理」のトピックを参照してください。

継承階層

System.Object
  System.Xml.XPath.XPathDocument

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
XPathDocument メンバ
System.Xml.XPath 名前空間
XPathNavigator
その他の技術情報
XPath データ モデルを使用した XML データの処理

XPathDocument コンストラクタ (XmlReader, XmlSpace)

指定した XmlReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化し、指定した空白処理を行います。

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

Visual Basic (宣言)

Public Sub New ( _
    reader As XmlReader, _
    space As XmlSpace _
)

Visual Basic (使用法)

Dim reader As XmlReader
Dim space As XmlSpace

Dim instance As New XPathDocument(reader,
 space)

C#

public XPathDocument (
    XmlReader reader,
    XmlSpace space
)

C++

public:
XPathDocument (
    XmlReader^ reader, 
    XmlSpace space
)

J#

public XPathDocument (
    XmlReader reader, 
    XmlSpace space
)

JScript

public function XPathDocument (
    reader : XmlReader, 
    space : XmlSpace
)

パラメータ

reader

XML データを格納している XmlReader オブジェクト。

space

XmlSpace オブジェクト。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	XmlReader オブジェクト パラメータまたは XmlSpace オブジェクト パラメータが null 参照 (Visual Basic では Nothing) です。

解説

• パラメータとして渡された XmlSpace オブジェクトは、空白を保持するかどうかを指定します。Default は、有意の空白だけを保持し、Preserve はすべての空白を保持します。既定では、XmlSpace オブジェクトは Default に設定されます。

• XPathDocument コンストラクタの機能は、空白の処理オプションが記述されている点を除いて、XPathDocument コンストラクタの機能と同じです。

プラットフォーム

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

参照

関連項目
XPathDocument クラス
XPathDocument メンバ
System.Xml.XPath 名前空間
XmlSpace 列挙体

XPathDocument コンストラクタ (Stream)

指定した Stream オブジェクトの XML データから XPathDocument クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    stream As Stream _
)

Visual Basic (使用法)

Dim stream As Stream

Dim instance As New XPathDocument(stream)

C#

public XPathDocument (
    Stream stream
)

C++

public:
XPathDocument (
    Stream^ stream
)

J#

public XPathDocument (
    Stream stream
)

JScript

public function XPathDocument (
    stream : Stream
)

パラメータ

stream

XML データを格納している Stream オブジェクト。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	パラメータとして渡される Stream オブジェクトは null 参照 (Visual Basic では Nothing) です。

プラットフォーム

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

参照

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

XPathDocument コンストラクタ (String, XmlSpace)

指定したファイルの XML データから XPathDocument クラスの新しいインスタンスを初期化し、指定した空白処理を行います。

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

Visual Basic (宣言)

Public Sub New ( _
    uri As String, _
    space As XmlSpace _
)

Visual Basic (使用法)

Dim uri As String
Dim space As XmlSpace

Dim instance As New XPathDocument(uri,
 space)

C#

public XPathDocument (
    string uri,
    XmlSpace space
)

C++

public:
XPathDocument (
    String^ uri, 
    XmlSpace space
)

J#

public XPathDocument (
    String uri, 
    XmlSpace space
)

JScript

public function XPathDocument (
    uri : String, 
    space : XmlSpace
)

パラメータ

uri

XML データを格納しているファイルのパス。

space

XmlSpace オブジェクト。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	ファイル パスのパラメータまたは XmlSpace オブジェクト パラメータが null 参照 (Visual Basic では Nothing) です。

解説

• パラメータとして渡された XmlSpace オブジェクトは、空白を保持するかどうかを指定します。Default は、有意の空白だけを保持し、Preserve はすべての空白を保持します。既定では、XmlSpace オブジェクトは Default に設定されます。

• XPathDocument コンストラクタの機能は、空白の処理オプションが記述されている点を除いて、XPathDocument コンストラクタの機能と同じです。

プラットフォーム

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

参照

関連項目
XPathDocument クラス
XPathDocument メンバ
System.Xml.XPath 名前空間
XmlSpace 列挙体

XPathDocument コンストラクタ (TextReader)

指定した TextReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    textReader As TextReader _
)

Visual Basic (使用法)

Dim textReader As TextReader

Dim instance As New XPathDocument(textReader)

C#

public XPathDocument (
    TextReader textReader
)

C++

public:
XPathDocument (
    TextReader^ textReader
)

J#

public XPathDocument (
    TextReader textReader
)

JScript

public function XPathDocument (
    textReader : TextReader
)

パラメータ

textReader

XML データを格納している TextReader オブジェクト。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	パラメータとして渡される TextReader オブジェクトは null 参照 (Visual Basic では Nothing) です。

解説

TextReader オブジェクトを使用して XML データを読み込んだ後、TextReader オブジェクトのカーソルはデータの最後に位置しています。このため、TextReader オブジェクトをリセットして、データ全体を再度読み取る必要があります。

プラットフォーム

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

参照

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

XPathDocument コンストラクタ

XPathDocument クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
XPathDocument (Stream)	指定した Stream オブジェクトの XML データから XPathDocument クラスの新しいインスタンスを初期化します。
XPathDocument (String)	指定したファイルの XML データから XPathDocument クラスの新しいインスタンスを初期化します。
XPathDocument (TextReader)	指定した TextReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化します。
XPathDocument (XmlReader)	指定した XmlReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化します。
XPathDocument (String, XmlSpace)	指定したファイルの XML データから XPathDocument クラスの新しいインスタンスを初期化し、指定した空白処理を行います。
XPathDocument (XmlReader, XmlSpace)	指定した XmlReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化し、指定した空白処理を行います。

参照

関連項目

XPathDocument クラス
XPathDocument メンバ
System.Xml.XPath 名前空間

XPathDocument コンストラクタ (String)

指定したファイルの XML データから XPathDocument クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    uri As String _
)

Visual Basic (使用法)

Dim uri As String

Dim instance As New XPathDocument(uri)

C#

public XPathDocument (
    string uri
)

C++

public:
XPathDocument (
    String^ uri
)

J#

public XPathDocument (
    String uri
)

JScript

public function XPathDocument (
    uri : String
)

パラメータ

uri

XML データを格納しているファイルのパス。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	ファイル パスのパラメータが null 参照 (Visual Basic では Nothing) です。

解説

空白を保持するには、XmlSpace オブジェクトをパラメータとして受け入れる XPathDocument コンストラクタを使用します。

プラットフォーム

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

参照

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

XPathDocument コンストラクタ (XmlReader)

指定した XmlReader オブジェクトに格納されている XML データから XPathDocument クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    reader As XmlReader _
)

Visual Basic (使用法)

Dim reader As XmlReader

Dim instance As New XPathDocument(reader)

C#

public XPathDocument (
    XmlReader reader
)

C++

public:
XPathDocument (
    XmlReader^ reader
)

J#

public XPathDocument (
    XmlReader reader
)

JScript

public function XPathDocument (
    reader : XmlReader
)

パラメータ

reader

XML データを格納している XmlReader オブジェクト。

例外

例外の種類	条件
XmlException	XML データでエラーが発生しました。XPathDocument が空です。
ArgumentNullException	パラメータとして渡される XmlReader オブジェクトは null 参照 (Visual Basic では Nothing) です。

解説

XmlReader オブジェクトを使用して、XML ドキュメント全体を XPathDocument に読み込むことができます。また、XML ドキュメントの一部だけを読み込むこともできます。XML ドキュメントの一部を XPathDocument に読み込むには、XmlReader オブジェクトを、データの読み込み元である XML ノードの最上位レベルに配置します。XPathDocument コンストラクタを使用して XPathDocument を作成する場合、データは現在の最上位ノードから読み込まれ、そのノードの終了タグに達するまで読み込みが続けられます。子ノードのデータはすべて含まれます。

XPathDocument コンストラクタを使用するときに考慮する必要がある重要な注意事項を次に示します。

• XmlReader オブジェクトとそれに適切に関連付けられている XmlResolver オブジェクト設定を使用して、XML データ内のエンティティまたはその他の参照を解決できます。

• XmlReader オブジェクトが、空白や属性ノードなど、ドキュメントのルート レベルでは有効ではない葉ノードに配置されている場合、XmlReader オブジェクトは、ルートで使用できるノードに配置されるまで読み取りを続行します。XPathDocument は、この時点で読み込みを開始します。

• 空白を保持するには、XmlSpace オブジェクトをパラメータとして受け入れる XPathDocument コンストラクタを使用します。

プラットフォーム

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

参照

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

XPathDocument メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateNavigator	読み取り専用の XPathNavigator オブジェクトを初期化します。このオブジェクトは、XPathDocument のノード内の移動に使用されます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

XPathDocument クラス
System.Xml.XPath 名前空間
XPathNavigator

その他の技術情報

XPath データ モデルを使用した XML データの処理

XPathDocument メンバ

XPath データ モデルを使用して、XML ドキュメントの読み取り専用で高速なインメモリ表現を提供します。

XPathDocument データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	XPathDocument	オーバーロードされます。 XPathDocument クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateNavigator	読み取り専用の XPathNavigator オブジェクトを初期化します。このオブジェクトは、XPathDocument のノード内の移動に使用されます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

XPathDocument クラス
System.Xml.XPath 名前空間
XPathNavigator

その他の技術情報

XPath データ モデルを使用した XML データの処理