XmlSchemaValidator.GetExpectedParticles メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XmlSchemaValidator.GetExpectedParticles メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要素コンテキストで予期されるパーティクルを返します。

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

Visual Basic (宣言)

Public Function GetExpectedParticles As
 XmlSchemaParticle()

Visual Basic (使用法)

Dim instance As XmlSchemaValidator
Dim returnValue As XmlSchemaParticle()

returnValue = instance.GetExpectedParticles

public XmlSchemaParticle[] GetExpectedParticles ()

C++

public:
array<XmlSchemaParticle^>^ GetExpectedParticles ()

public XmlSchemaParticle[] GetExpectedParticles ()

JScript

public function GetExpectedParticles () : XmlSchemaParticle[]

戻り値
XmlSchemaParticle オブジェクトの配列。または、予期されるパーティクルがない場合は空の配列。

解説

GetExpectedParticles メソッドで返すことができる有効なパーティクルは、XmlSchemaElement クラスおよび XmlSchemaAny クラスのインスタンスです。

コンテンツモデルのコンポジタが xs:sequence の場合、シーケンス内にある次のパーティクルだけが返されます。コンテンツモデルのコンポジタが xs:all または xs:choice の場合は、現在の要素コンテキストに続くすべての有効なパーティクルが返されます。

たとえば、XML スキーマ定義言語 (XSD) スキーマおよびそれに続く XML ドキュメントでは、book 要素を検証した後の現在の要素コンテキストは book 要素になります。GetExpectedParticles メソッドは、title 要素を表す単一の XmlSchemaElement オブジェクトが格納された配列を返します。検証コンテキストが title 要素の場合、GetExpectedParticles メソッドは空の配列を返します。title 要素が検証された後、description 要素が検証されるまでの間に GetExpectedParticles メソッドを呼び出すと、description 要素を表す単一の XmlSchemaElement オブジェクトが格納された配列が返されます。description 要素が検証された後で GetExpectedParticles メソッドを呼び出すと、ワイルドカードを表す単一の XmlSchemaAny オブジェクトが格納された配列が返されます。

Visual Basic

Dim reader As XmlReader =  XmlReader.Create("input.xml")
 

Dim schemaSet As XmlSchemaSet =  New
 XmlSchemaSet() 
schemaSet.Add(Nothing, "schema.xsd")
Dim manager As XmlNamespaceManager =  New
 XmlNamespaceManager(reader.NameTable) 

Dim validator As XmlSchemaValidator =  New
 XmlSchemaValidator(reader.NameTable,schemaSet,manager,XmlSchemaValidationFlags.None)
validator.Initialize()
 
validator.ValidateElement("book", "",
 Nothing)

validator.ValidateEndOfAttributes(Nothing)
For Each element As XmlSchemaElement
 In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
 
validator.ValidateElement("title", "",
 Nothing)
validator.ValidateEndOfAttributes(Nothing)
For Each element As XmlSchemaElement
 In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
validator.ValidateEndElement(Nothing)
 
For Each element As XmlSchemaElement
 In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
 
validator.ValidateElement("description", "",
 Nothing)
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateEndElement(Nothing)
 
For Each particle As XmlSchemaParticle
 In validator.GetExpectedParticles()
    Console.WriteLine(particle.GetType())
Next
 
validator.ValidateElement("namespace", "",
 Nothing)
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateEndElement(Nothing)
 
validator.ValidateEndElement(Nothing)

XmlReader reader = XmlReader.Create("input.xml");

XmlSchemaSet schemaSet = new XmlSchemaSet();
schemaSet.Add(null, "schema.xsd");
XmlNamespaceManager manager = new XmlNamespaceManager(reader.NameTable);

XmlSchemaValidator validator = new XmlSchemaValidator(reader.NameTable,
 schemaSet, manager, XmlSchemaValidationFlags.None);
validator.Initialize();

validator.ValidateElement("book", "", null);
            
validator.ValidateEndOfAttributes(null);
foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}

validator.ValidateElement("title", "", null);
validator.ValidateEndOfAttributes(null);
foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}
validator.ValidateEndElement(null);

foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}

validator.ValidateElement("description", "", null);
validator.ValidateEndOfAttributes(null);
validator.ValidateEndElement(null);

foreach (XmlSchemaParticle particle in validator.GetExpectedParticles())
{
    Console.WriteLine(particle.GetType());
}

validator.ValidateElement("namespace", "",
 null);
validator.ValidateEndOfAttributes(null);
validator.ValidateEndElement(null);

validator.ValidateEndElement(null);