XmlReader.IsEmptyElement Vlastnost

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální uzel je 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

XmlReader Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již 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 vlastnostmi:

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

<item num="123"></item> (IsEmptyElement je false, i když je obsah prvku prázdný).

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

Pokud byl do elementu přidán výchozí obsah kvůli ověření schématu, IsEmptyElement vrátí se truestále . 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.

Platí pro

Sdílet prostřednictvím