Μέθοδος System::Xml::XmlDocument::CreateXmlDeclaration

XmlDocument::CreateXmlDeclaration method

Δημιουργεί έναν κόμβο XmlDeclaration με τις συγκεκριμένες τιμές.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ParameterTypeΠεριγραφή
έκδοσηconst String&Η έκδοση πρέπει να είναι “1.0”.
encodingconst String&Η τιμή του χαρακτηριστικού κωδικοποίησης. Αυτή είναι η κωδικοποίηση που χρησιμοποιείται όταν αποθηκεύετε το XmlDocument σε αρχείο ή ροή· επομένως, πρέπει να οριστεί σε μια συμβολοσειρά που υποστηρίζεται από την κλάση Text::Encoding, διαφορετικά η λειτουργία “XmlDocument::Save(String)” αποτυγχάνει. Εάν είναι nullptr ή String::Empty, η μέθοδος XmlDocument::Save δεν γράφει χαρακτηριστικό κωδικοποίησης στην δήλωση XML και έτσι χρησιμοποιείται η προεπιλεγμένη κωδικοποίηση, UTF-8.
standaloneconst String&Η τιμή πρέπει να είναι είτε “yes” είτε “no”. Εάν είναι nullptr ή String::Empty, η μέθοδος XmlDocument::Save δεν γράφει χαρακτηριστικό standalone στην δήλωση XML.

ReturnValue

Ο νέος κόμβος XmlDeclaration.

Παρατηρήσεις

Σημείωση: Εάν το XmlDocument αποθηκευτεί είτε σε TextWriter είτε σε XmlTextWriter, αυτή η τιμή κωδικοποίησης απορρίπτεται. Αντίθετα, χρησιμοποιείται η κωδικοποίηση του TextWriter ή του XmlTextWriter. Αυτό εξασφαλίζει ότι το XML που γράφεται μπορεί να αναγνωστεί ξανά χρησιμοποιώντας τη σωστή κωδικοποίηση.

Δείτε επίσης