XmlElement.IsEmpty-Eigenschaft

Ruft das Tagformat des Elements ab oder legt dieses fest.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Property IsEmpty As Boolean
'Usage
Dim instance As XmlElement
Dim value As Boolean

value = instance.IsEmpty

instance.IsEmpty = value

public bool IsEmpty { get; set; }

public:
property bool IsEmpty {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_IsEmpty ()

/** @property */
public void set_IsEmpty (boolean value)

public function get IsEmpty () : boolean

public function set IsEmpty (value : boolean)

Eigenschaftenwert

Gibt true zurück, wenn das Element im kurzen Tagformat "<item/>" serialisiert werden soll, false für das lange Format "<item></item>". Wenn diese Eigenschaft auf true festgelegt ist, werden die dem Element untergeordneten Elemente entfernt, und das Element wird im kurzen Tagformat serialisiert. Wenn die Eigenschaft auf false festgelegt ist, ändert sich der Wert der Eigenschaft (unabhängig davon, ob das Element leer ist oder nicht). Wenn das Element leer ist, wird es im langen Format serialisiert. Diese Eigenschaft ist eine Microsoft-Erweiterung des Dokumentobjektmodells (Document Object Model, DOM).

Hinweise

Diese Eigenschaft ist eine Microsoft-Erweiterung des Dokumentobjektmodells (DOM).

Beispiel

Im folgenden Beispiel werden Inhalte einem leeren Dokument hinzugefügt.

Imports System
Imports System.Xml

public class Sample

  public shared sub Main()
  
      Dim doc as XmlDocument = new XmlDocument()
      doc.LoadXml("<book>" & _
                  "  <title>Pride And Prejudice</title>" & _
                  "  <price/>" & _
                  "</book>")   

      Dim currNode as XmlElement 
      currNode = CType (doc.DocumentElement.LastChild, XmlElement)
      if (currNode.IsEmpty)
        currNode.InnerXml="19.95"
      end if

      Console.WriteLine("Display the modified XML...")
      Console.WriteLine(doc.OuterXml)

  end sub
end class

using System;
using System.Xml;

public class Sample {

  public static void Main() {

      XmlDocument doc = new XmlDocument();
      doc.LoadXml("<book>"+ 
                  "  <title>Pride And Prejudice</title>" +
                  "  <price/>" +
                  "</book>");     
 
      XmlElement currNode = (XmlElement) doc.DocumentElement.LastChild;
      if (currNode.IsEmpty)
        currNode.InnerXml="19.95"; 

      Console.WriteLine("Display the modified XML...");
      Console.WriteLine(doc.OuterXml);

  }
}

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book>  <title>Pride And Prejudice</title>  <price/></book>" );
   XmlElement^ currNode = dynamic_cast<XmlElement^>(doc->DocumentElement->LastChild);
   if ( currNode->IsEmpty )
      currNode->InnerXml = "19.95";

   Console::WriteLine( "Display the modified XML..." );
   Console::WriteLine( doc->OuterXml );
}

import System.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book>"
            + "<title>Pride And Prejudice</title>"
            + "<price/>"
            + "</book>");

        XmlElement currNode = 
            (XmlElement)doc.get_DocumentElement().get_LastChild();
        if (currNode.get_IsEmpty()) {
            currNode.set_InnerXml("19.95");
        }

        Console.WriteLine("Display the modified XML...");
        Console.WriteLine(doc.get_OuterXml());
    } //main 
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlElement-Klasse
XmlElement-Member
System.Xml-Namespace