XmlSchemaValidator.GetExpectedParticles Yöntem

Tanım

Ad Alanı:

System.Xml.Schema

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlSchemaValidator.cs

Geçerli eleman bağlamında beklenen parçacıkları döndürür.

public:
 cli::array <System::Xml::Schema::XmlSchemaParticle ^> ^ GetExpectedParticles();

public System.Xml.Schema.XmlSchemaParticle[] GetExpectedParticles();

member this.GetExpectedParticles : unit -> System.Xml.Schema.XmlSchemaParticle[]

Public Function GetExpectedParticles () As XmlSchemaParticle()

Döndürülenler

XmlSchemaParticle[]

XmlSchemaParticle Beklenen parçacıklar yoksa bir nesne dizisi veya boş bir dizi.

Açıklamalar

GetExpectedParticles yöntemi tarafından döndürülebilecek geçerli parçacıklar, XmlSchemaElement ve XmlSchemaAny sınıflarının örnekleridir.

İçerik modelinin oluşturucu bir xs:sequenceolduğunda, dizideki yalnızca sonraki parçacık döndürülür. İçerik modelinin oluşturucu xs:all veya xs:choice ise, geçerli öğe bağlamında izleyebilecek tüm geçerli parçacıklar döndürülür.

Örneğin, izleyen XML Şema Tanım Dili (XSD) şemasında ve XML belgesinde, book öğesi doğrulandıktan sonra, book geçerli öğe bağlamıdır. GetExpectedParticles yöntemi, XmlSchemaElement öğesini temsil eden tek bir title nesne içeren bir dizi döndürür. Doğrulama bağlamı öğesi olduğunda title , GetExpectedParticles yöntemi boş bir dizi döndürür. GetExpectedParticles yöntemi title öğesi doğrulandıktan sonra ancak description öğesi doğrulanmadan önce çağrılırsa, XmlSchemaElement öğesini temsil eden bir tek description nesne içeren bir dizi döndürür. GetExpectedParticles öğesi doğrulandıktan sonra description yöntemi çağrılırsa joker karakteri temsil eden tek XmlSchemaAny bir nesne içeren bir dizi döndürür.

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.GetUnspecifiedDefaultAttributes(New ArrayList())
validator.ValidateEndOfAttributes(Nothing)
For Each element As XmlSchemaElement In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next

validator.ValidateElement("title", "", Nothing)
validator.GetUnspecifiedDefaultAttributes(New ArrayList())
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.GetUnspecifiedDefaultAttributes(New ArrayList())
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateEndElement(Nothing)

For Each particle As XmlSchemaParticle In validator.GetExpectedParticles()
    Console.WriteLine(particle.GetType())
Next

validator.ValidateElement("namespace", "", Nothing)
validator.GetUnspecifiedDefaultAttributes(New ArrayList())
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.GetUnspecifiedDefaultAttributes(new ArrayList());
validator.ValidateEndOfAttributes(null);
foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}

validator.ValidateElement("title", "", null);
validator.GetUnspecifiedDefaultAttributes(new ArrayList());
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.GetUnspecifiedDefaultAttributes(new ArrayList());
validator.ValidateEndOfAttributes(null);
validator.ValidateEndElement(null);

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

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

validator.ValidateEndElement(null);

Örnek, giriş olarak aşağıdaki XML'yi alır.

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="book">

<xs:complexType>

<xs:sequence>

<xs:element name="title" type="xs:string" />

<xs:element name="description" type="xs:string" />

<xs:any processContents ="lax"/>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:schema>

Örnek, giriş olarak aşağıdaki XSD şemasını alır.

<book>

<title>My Book</title>

<description>My Book's Description</description>

<namespace>System.Xml.Schema</namespace>

</book>

Ayrıca bkz.

• XmlSchemaParticle
• XmlSchemaElement
• XmlSchemaAny