次の方法で共有

XmlTextReader コンストラクタ (Stream, XmlNodeType, XmlParserContext)

指定したストリーム、XmlNodeType、および XmlParserContext を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    xmlFragment As Stream, _
    fragType As XmlNodeType, _
    context As XmlParserContext _
)
'使用
Dim xmlFragment As Stream
Dim fragType As XmlNodeType
Dim context As XmlParserContext

Dim instance As New XmlTextReader(xmlFragment, fragType, context)

public XmlTextReader (
    Stream xmlFragment,
    XmlNodeType fragType,
    XmlParserContext context
)

public:
XmlTextReader (
    Stream^ xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext^ context
)

public XmlTextReader (
    Stream xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext context
)

public function XmlTextReader (
    xmlFragment : Stream, 
    fragType : XmlNodeType, 
    context : XmlParserContext
)

パラメータ

  • xmlFragment
    解析する XML フラグメントを含んでいるストリーム。
  • fragType
    XML フラグメントの XmlNodeType。これもフラグメントに何を含めることができるかを判断します。下の表を参照してください。
  • context
    xmlFragment の解析先の XmlParserContext。これには、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:lang、および xml:space スコープが含まれます。

例外

例外の種類 条件

XmlException

fragType が Element、Attribute、または Document のいずれかの XmlNodeType ではありません。

ArgumentNullException

xmlFragment が null 参照 (Visual Basic では Nothing) です。

解説

注意

Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

このコンストラクタは、指定した文字列を XML のフラグメントとして解析します。XML フラグメントが要素または属性の場合は、整形式 XML ドキュメントのルート レベルの規則をバイパスできます。

fragType の有効な値の一覧を次の表に示します。

XmlNodeType

フラグメントに含まれる

Element

任意の有効な要素の内容 (たとえば、要素、コメント、処理命令、CDATA セクション、テキスト、およびエンティティ参照の任意の組み合わせ)。

XML 宣言も設定できます。これにより XML フラグメントのエンコーディングを指定できるため、XmlParserContext オブジェクトにそれを設定する必要はありません。

Attribute

属性の値 (引用符の内側の部分)。

Document

XML ドキュメント全体の内容。これにより、ドキュメント レベルの規則が適用されます。

リーダーは、次を使用してストリームのエンコーディングを判断します。

  1. XmlParserContext.Encoding プロパティをチェックして、エンコーディングを判断します。

  2. Encoding プロパティが null 参照 (Visual Basic では Nothing) の場合、リーダーは、ストリームの先頭でバイト順のマークを確認します。

  3. Encoding プロパティが null 参照 (Visual Basic では Nothing) で、バイト順のマークが見つからない場合は、リーダーは、ストリームが UTF-8 でエンコードされることを前提とします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

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

その他の技術情報

XmlReader による XML の読み取り