XmlReader.IsEmptyElement Tulajdonság

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReader.cs

Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális csomópont üres elem-e (például <MyElement/>).

public:
 abstract property bool IsEmptyElement { bool get(); };

public abstract bool IsEmptyElement { get; }

member this.IsEmptyElement : bool

Public MustOverride ReadOnly Property IsEmptyElement As Boolean

Tulajdonság értéke

Boolean

trueha az aktuális csomópont egy elem (NodeType egyenlő XmlNodeType.Element) , amely a következővel />végződik: ; egyébként. false

Kivételek

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

Az alábbi példa az egyes elemek szöveges tartalmát jeleníti meg.

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
                {
                    Console.WriteLine("<{0}/>", reader.Name);
                }
                else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  }
}

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

A példa a fájlt elems.xmlhasználja bemenetként.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Megjegyzések

Ez a tulajdonság lehetővé teszi, hogy meghatározza a különbséget a következők között:

<item num="123"/> (IsEmptyElement is true).

<item num="123"></item> (IsEmptyElement az false, bár az elem tartalma üres).

A rendszer nem hoz létre megfelelő EndElement csomópontot üres elemekhez.

Ha az alapértelmezett tartalom sémaérvényesítés miatt lett hozzáadva egy elemhez, IsEmptyElement akkor is visszaadja a függvényt true. Nincs hatással arra, hogy az elem alapértelmezett értékkel rendelkezik-e. Más szóval egyszerűen azt jelenti, IsEmptyElement hogy a forrásdokumentum eleme rendelkezik-e végfelhasználói címkével.