System::Xml::XmlDocument::CreateXmlDeclaration طريقة

XmlDocument::CreateXmlDeclaration method

يُنشئ عقدة XmlDeclaration بالقيم المحددة.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
معاملنوعالوصف
إصدار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 لا تكتب سمة مستقلة على إعلان XML.

ReturnValue

العقدة الجديدة XmlDeclaration.

ملاحظات

ملاحظة: إذا تم حفظ الـ XmlDocument إلى إما TextWriter أو XmlTextWriter، يتم تجاهل قيمة الترميز هذه. بدلاً من ذلك، يُستخدم ترميز الـ TextWriter أو XmlTextWriter. يضمن ذلك أن XML المكتوب يمكن قراءته مرة أخرى باستخدام الترميز الصحيح.

انظر أيضًا