Obsolete Members for QDomDocument

Die folgenden Mitglieder der Klasse QDomDocument sind veraltet. Sie werden bereitgestellt, um alten Quellcode funktionsfähig zu halten. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Funktionen

Dokumentation der Mitgliedsfunktionen

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladung, die ParseResult zurückgibt.

Diese Funktion liest das XML-Dokument aus dem IO-Gerät dev und gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls gibt sie false zurück.

Es wird keine Namespace-Verarbeitung durchgeführt.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &buffer, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladung, die ParseResult zurückgibt.

Diese Funktion liest das XML-Dokument aus dem Byte-Array buffer und gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls wird false zurückgegeben.

Es wird keine Namespace-Verarbeitung durchgeführt.

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, QString *errorMsg, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladung, die ParseResult zurückgibt.

Diese Funktion liest das XML-Dokument aus dem String text und gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls gibt sie false zurück. Da text bereits ein Unicode-String ist, wird keine Kodierungserkennung durchgeführt.

Es wird auch keine Namespace-Verarbeitung durchgeführt.

[deprecated in 6.8] bool QDomDocument::setContent(QIODevice *dev, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladung mit ParseOptions.

Diese Funktion liest das XML-Dokument aus dem IO-Gerät dev und gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls gibt sie false zurück.

[deprecated in 6.8] bool QDomDocument::setContent(QXmlStreamReader *reader, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladung mit ParseOptions.

Diese Funktion liest das XML-Dokument von QXmlStreamReader reader und parst es. Gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls gibt sie false zurück.

Wenn namespaceProcessing true ist, erkennt der Parser Namespaces in der XML-Datei und setzt den Präfixnamen, den lokalen Namen und den Namespace-URI auf die entsprechenden Werte. Wenn namespaceProcessing gleich false ist, führt der Parser keine Namespace-Verarbeitung durch, wenn er die XML-Datei liest.

Tritt ein Parse-Fehler auf, wird die Fehlermeldung in *errorMsg , die Zeilennummer in *errorLine und die Spaltennummer in *errorColumn gespeichert (sofern der zugehörige Zeiger nicht auf nullptr gesetzt ist).

Siehe auch QXmlStreamReader.

[deprecated in 6.8] bool QDomDocument::setContent(const QByteArray &data, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen die Überladung mit ParseOptions.

Dies ist eine überladene Funktion.

Diese Funktion parst das XML-Dokument aus dem Byte-Array data und setzt es als den Inhalt des Dokuments. Sie versucht, die von der XML-Spezifikation geforderte Kodierung des Dokuments zu erkennen.

Wenn namespaceProcessing wahr ist, erkennt der Parser die Namespaces in der XML-Datei und setzt den Präfixnamen, den lokalen Namen und den Namespace-URI auf die entsprechenden Werte. Wenn namespaceProcessing falsch ist, führt der Parser beim Lesen der XML-Datei keine Namespace-Verarbeitung durch.

Wenn ein Parse-Fehler auftritt, gibt diese Funktion false zurück und die Fehlermeldung wird in *errorMsg , die Zeilennummer in *errorLine und die Spaltennummer in *errorColumn (sofern der zugehörige Zeiger nicht auf nullptr gesetzt ist) abgelegt; andernfalls gibt diese Funktion true zurück.

Wenn namespaceProcessing wahr ist, gibt die Funktion QDomNode::prefix() einen String für alle Elemente und Attribute zurück. Sie gibt eine leere Zeichenkette zurück, wenn das Element oder Attribut kein Präfix hat.

Textknoten, die nur aus Whitespace bestehen, werden entfernt und erscheinen nicht in QDomDocument.

Wenn namespaceProcessing falsch ist, geben die Funktionen QDomNode::prefix(), QDomNode::localName() und QDomNode::namespaceURI() eine leere Zeichenkette zurück.

Entitätsreferenzen werden wie folgt behandelt:

• Verweise auf interne allgemeine Entitäten und Zeichenentitäten, die im Inhalt vorkommen, werden einbezogen. Das Ergebnis ist ein QDomText Knoten, in dem die Referenzen durch die entsprechenden Entitätswerte ersetzt werden.
• Verweise auf Parameterentitäten, die in der internen Untermenge vorkommen, werden einbezogen. Das Ergebnis ist ein QDomDocumentType Knoten, der Entitäts- und Notationsdeklarationen enthält, wobei die Referenzen durch die entsprechenden Entitätswerte ersetzt werden.
• Jede allgemeine geparste Entitätsreferenz, die nicht in der internen Untermenge definiert ist und im Inhalt vorkommt, wird als QDomEntityReference -Knoten dargestellt.
• Jede geparste Entitätsreferenz, die nicht in der internen Teilmenge definiert ist und außerhalb des Inhalts vorkommt, wird durch einen leeren String ersetzt.
• Jede nicht geparste Entity-Referenz wird durch eine leere Zeichenkette ersetzt.

Siehe auch QDomNode::namespaceURI(), QDomNode::localName(), QDomNode::prefix(), QString::isNull(), und QString::isEmpty().

[deprecated in 6.8] bool QDomDocument::setContent(const QString &text, bool namespaceProcessing, QString *errorMsg = nullptr, int *errorLine = nullptr, int *errorColumn = nullptr)

Diese Funktion ist seit 6.8 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Dies ist eine überladene Funktion.

Verwenden Sie stattdessen die Überladungen mit ParseOptions.

Diese Funktion liest das XML-Dokument aus der Zeichenkette text und gibt true zurück, wenn der Inhalt erfolgreich geparst wurde; andernfalls gibt sie false zurück. Da text bereits ein Unicode-String ist, wird keine Kodierungserkennung durchgeführt.