XmlValidatingReader コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XmlValidatingReader クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| XmlValidatingReader(XmlReader) |
指定したXmlReaderから返されたコンテンツを検証する |
| XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) |
指定した値を使用して、 |
| XmlValidatingReader(String, XmlNodeType, XmlParserContext) |
指定した値を使用して、 |
XmlValidatingReader(XmlReader)
指定したXmlReaderから返されたコンテンツを検証するXmlValidatingReader クラスの新しいインスタンスを初期化します。
public:
XmlValidatingReader(System::Xml::XmlReader ^ reader);public XmlValidatingReader(System.Xml.XmlReader reader);new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReaderPublic Sub New (reader As XmlReader)パラメーター
- reader
- XmlReader
検証中に読み取る XmlReader 。 現在の実装では、 XmlTextReaderのみがサポートされています。
例外
指定されたリーダーが XmlTextReaderではありません。
注釈
注
XmlValidatingReader クラスは、.NET Framework 2.0 では使用されなくなりました。 XmlReaderSettings クラスと Create メソッドを使用して、検証XmlReaderインスタンスを作成できます。 詳細については、XmlReader のリファレンス ページの「解説」を参照してください。
指定された XmlReader から返されるすべてのノードも、この検証リーダーから返されるため、プロセスで情報が失われる可能性はありません。 基になるリーダーから返されない新しいノードは、このリーダー (既定の属性やエンティティ参照の子など) によって追加できます。 指定された XmlTextReader に設定されたすべてのプロパティは、この検証リーダーにも適用されます。 たとえば、指定されたリーダーに WhitespaceHandling.None が設定されている場合、この検証リーダーは空白も無視します。
検証に外部ドキュメント型定義 (DTD) またはスキーマが必要な場合、 XmlResolver プロパティは、外部リソースの解決に使用する XmlResolver オブジェクトを設定します。
こちらもご覧ください
適用対象
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)
指定した値を使用して、 XmlValidatingReader クラスの新しいインスタンスを初期化します。
public:
XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)パラメーター
- xmlFragment
- Stream
解析する XML フラグメントを含むストリーム。
- fragType
- XmlNodeType
XML フラグメントの XmlNodeType 。 これにより、フラグメントに含めることができる内容が決まります (下の表を参照)。
- context
- XmlParserContext
XML フラグメントを解析する XmlParserContext 。 これには、使用する XmlNameTable 、エンコード、名前空間スコープ、現在の xml:lang、および xml:space スコープが含まれます。
例外
fragType は、次の表に示すノード タイプの 1 つではありません。
注釈
注
XmlValidatingReader クラスは、.NET Framework 2.0 では使用されなくなりました。 XmlReaderSettings クラスと Create メソッドを使用して、検証XmlReaderインスタンスを作成できます。 詳細については、XmlReader のリファレンス ページの「解説」を参照してください。
このコンストラクターは、指定された文字列を XML のフラグメントとして解析します。 XML フラグメントが要素または属性の場合は、整形式の XML ドキュメントのルート レベルの規則をバイパスできます。
次の表に、 fragType の有効な値と、リーダーが各ノード タイプを解析する方法を示します。
| XmlNodeType | フラグメントに含まれる可能性がある |
|---|---|
| 要素 | 任意の有効な要素コンテンツ (要素、コメント、処理命令、cdata、テキスト、エンティティ参照の任意の組み合わせなど)。 |
| 特性 | 属性の値 (引用符内の部分)。 |
| ドキュメント | XML ドキュメント全体の内容。これにより、ドキュメント レベルの規則が適用されます。 |
リーダーは、次の手順を使用してストリームのエンコードを決定します。
XmlParserContext.Encoding プロパティを調べてエンコードを決定します。
Encodingプロパティがnullされている場合、リーダーはストリームの先頭でバイトオーダー マークをチェックします。Encodingプロパティがnullされ、バイトオーダー マークが見つからない場合、リーダーはストリームが UTF-8 でエンコードされていると見なします。
このリーダーがドキュメント型定義 (DTD) を使用して検証する場合 (つまり、 ValidationType が ValidationType.DTD または ValidationType.Auto に設定されている場合)、コンストラクターで指定された XmlParserContext は、必要なすべての DocumentType 情報を指定する必要があります。
注
DTD を使用してフラグメントを検証することはできません。 定義上、DTD では検証のためにドキュメント全体を読み込む必要があります。
このリーダーが XML-Data 縮小 (XDR) または XML スキーマ定義言語 (XSD) スキーマを使用して検証する場合は、 Schemas プロパティを使用して、スキーマを含む XmlSchemaCollection を指定します (つまり、 XmlParserContext は DocumentType 情報を指定する必要はありません)。
こちらもご覧ください
適用対象
XmlValidatingReader(String, XmlNodeType, XmlParserContext)
指定した値を使用して、 XmlValidatingReader クラスの新しいインスタンスを初期化します。
public:
XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)パラメーター
- xmlFragment
- String
解析する XML フラグメントを含む文字列。
- fragType
- XmlNodeType
XML フラグメントの XmlNodeType 。 これは、フラグメント文字列に含めることができるものも決定します (下の表を参照)。
- context
- XmlParserContext
XML フラグメントを解析する XmlParserContext 。 これには、使用する NameTable 、エンコード、名前空間スコープ、現在の xml:lang、および xml:space スコープが含まれます。
例外
fragType は、次の表に示すノード タイプの 1 つではありません。
注釈
注
XmlValidatingReader クラスは、.NET Framework 2.0 では使用されなくなりました。 XmlReaderSettings クラスと Create メソッドを使用して、検証XmlReaderインスタンスを作成できます。 詳細については、XmlReader のリファレンス ページの「解説」を参照してください。
このコンストラクターは、指定された文字列を XML のフラグメントとして解析します。 XML フラグメントが要素または属性の場合は、整形式の XML ドキュメントのルート レベルの規則をバイパスできます。 このコンストラクターは、 ReadInnerXmlから返された文字列を処理できます。
次の表に、 fragType の有効な値と、リーダーが各ノード タイプを解析する方法を示します。
| XmlNodeType | フラグメントに含まれる可能性がある |
|---|---|
| 要素 | 任意の有効な要素コンテンツ (要素、コメント、処理命令、cdata、テキスト、エンティティ参照の任意の組み合わせなど)。 |
| 特性 | 属性の値 (引用符内の部分)。 |
| ドキュメント | XML ドキュメント全体の内容。これにより、ドキュメント レベルの規則が適用されます。 |
このリーダーがドキュメント型定義 (DTD) を使用して検証する場合 (つまり、 ValidationType が ValidationType.DTD または ValidationType.Auto に設定されている場合)、コンストラクターで指定された XmlParserContext は、必要なすべての DocumentType 情報を指定する必要があります。
注
DTD を使用してフラグメントを検証することはできません。 定義上 DTD では、検証のためにドキュメント全体を読み込む必要があります。
このリーダーが XML-Data 縮小 (XDR) または XML スキーマ定義言語 (XSD) スキーマを使用して検証する場合は、 Schemas プロパティを使用して、スキーマを含む XmlSchemaCollection を指定します ( XmlParserContext は DocumentType 情報を指定する必要はありません)。
