2.174 .ixmldomdocument2

Über dieses Attribut kann unter Microsoft Windows auf den IXMLDOMDocument2 COM Interface Pointer des XML-Dokuments zugegriffen werden. Wenn beim XML-Dokument ein neuer Wert gesetzt wird, wird der gespeicherte DOM-Baum gelöscht. Alle bestehenden XML-Cursor werden ungültig. Bei einem ungültigen XML-Cursor besitzt das Attribut .mapped den Wert false.

Definition

  • Datentyp

    pointer

  • Zugriff

    get, set

  • changed-Ereignis

    nein

In der Regelsprache darf das Attribut nur demselben Attribut eines anderen Dialog Manager Objektes zugewiesen werden. In den Programmierschnittstellen ist zu beachten, dass das COM Objekt nur so lange gültig ist, wie der Dialog Manager dieses verwendet. Eine Anwendung sollte deshalb nach einer Abfrage den Referenzzähler sofort erhöhen (COM Methode: IUnknown->AddRef). Wenn das Objekt nicht mehr gebraucht wird, muss der Zähler wieder herunter gezählt werden (COM Methode: IUnknown->Release). Es darf aber auf gar keinen Fall der Zähler öfter erniedrigt als erhöht werden, da sonst das COM Objekt freigegeben wird. Der Dialog Manager kann diese Situation nicht erkennen und wird abstürzen. Der Dialog Manager wird ebenso abstürzen, wenn der angegebene Zeiger nicht auf ein COM Interface zeigt.