XmlReader.IsEmptyElement Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReader.cs

Při přepsání v odvozené třídě získá hodnotu označující, zda je aktuální uzel prázdný prvek (například <MyElement/>).

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

public abstract bool IsEmptyElement { get; }

member this.IsEmptyElement : bool

Public MustOverride ReadOnly Property IsEmptyElement As Boolean

Hodnota vlastnosti

Boolean

true pokud je aktuální uzel prvkem (NodeType rovná XmlNodeType.Elementse), který končí />; v opačném případě false.

Výjimky

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad zobrazí textový obsah každého prvku.

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

Příklad používá soubor , elems.xmljako vstup.

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

Poznámky

Tato vlastnost umožňuje určit rozdíl mezi následujícími:

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

<item num="123"></item> (IsEmptyElement je false, ačkoli obsah prvku je prázdný).

Odpovídající EndElement uzel není generován pro prázdné prvky.

Pokud byl výchozí obsah přidán do elementu z důvodu ověření schématu, IsEmptyElement stále vrátí true. Nemá žádný vliv na to, zda má prvek výchozí hodnotu. Jinými slovy, jednoduše hlásí, IsEmptyElement zda prvek ve zdrojovém dokumentu měl značku koncového prvku.