طريقة 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 المكتوب مرة أخرى باستخدام الترميز الصحيح.

انظر أيضًا