فئة System::Xml::XmlTextWriter

XmlTextWriter class

يمثل كاتبًا يوفر طريقة سريعة غير مخزنة مؤقتًا لإنشاء تدفقات أو ملفات تحتوي على بيانات XML تتوافق مع توصيات لغة الترميز القابلة للامتداد (XML) 1.0 من W3C ومساحات الأسماء في XML.

class XmlTextWriter : public System::Xml::XmlWriter

الطرق

طريقةالوصف
Close() overrideيغلق هذا التدفق والتدفق الأساسي.
Flush() overrideيفرغ أي شيء موجود في المخزن المؤقت إلى التدفقات الأساسية ويفرغ أيضاً التدفق الأساسي.
get_BaseStream()يعيد كائن التدفق الأساسي.
get_Formatting()يشير إلى كيفية تنسيق الإخراج.
get_Indentation()يعيد عدد أحرف المسافة (IndentChars) التي يجب كتابتها لكل مستوى في التسلسل الهرمي عندما يتم تعيين XmlTextWriter::set_Formatting إلى Formatting::Indented.
get_IndentChar()يعيد أي حرف يُستخدم للمسافة البادئة عندما يتم تعيين XmlTextWriter::set_Formatting إلى Formatting::Indented.
get_Namespaces()يعيد قيمة تشير إلى ما إذا كان يجب دعم المساحات الاسمية.
get_QuoteChar()يعيد أي حرف يُستخدم لتحديد قيم السمات.
get_WriteState() overrideيعيد حالة الكاتب.
get_XmlLang() overrideيعيد نطاق xml:lang الحالي.
get_XmlSpace() overrideيعيد كائن XmlSpace الذي يمثل نطاق xml:space الحالي.
LookupPrefix(String) overrideيعيد أقرب بادئة معرفة في نطاق المساحة الاسمية الحالي لعنوان URI الخاص بالمساحة الاسمية.
set_Formatting(System::Xml::Formatting)يشير إلى كيفية تنسيق الإخراج.
set_Indentation(int32_t)يضبط عدد أحرف المسافة (IndentChars) التي تُكتب لكل مستوى في التسلسل الهرمي عندما يتم تعيين XmlTextWriter::set_Formatting إلى Formatting::Indented.
set_IndentChar(char16_t)يضبط أي حرف يُستخدم للمسافة البادئة عندما يتم تعيين XmlTextWriter::set_Formatting إلى Formatting::Indented.
set_Namespaces(bool)يضبط قيمة تشير إلى ما إذا كان سيتم دعم النطاقات.
set_QuoteChar(char16_t)يضبط أي حرف يُستخدم لاقتباس قيم السمات.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقوم بترميز البايتات الثنائية المحددة كـ base64 ويكتب النص الناتج.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقوم بترميز البايتات الثنائية المحددة كـ binhex ويكتب النص الناتج.
WriteCData(String) overrideيكتب كتلة تحتوي على النص المحدد.
WriteCharEntity(char16_t) overrideيفرض توليد كيان حرف للقيمة المحددة من حرف Unicode.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideيكتب النص مخزنًا مؤقتًا واحدًا في كل مرة.
WriteComment(String) overrideيكتب تعليق **** يحتوي على النص المحدد.
WriteDocType(const String&, const String&, const String&, const String&) overrideيكتب إعلان DOCTYPE بالاسم المحدد والسمات الاختيارية.
WriteEndAttribute() overrideيغلق الاستدعاء السابق لـ XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideيغلق أي عناصر أو سمات مفتوحة ويعيد الكاتب إلى حالة البداية.
WriteEndElement() overrideيغلق عنصرًا واحدًا ويزيل نطاق الاسم المقابل.
WriteEntityRef(const String&) overrideيكتب إشارة كيان كـ &name;.
WriteFullEndElement() overrideيغلق عنصرًا واحدًا ويزيل نطاق الاسم المقابل.
WriteName(const String&) overrideيكتب الاسم المحدد، مع التأكد من أنه اسم صالح وفقًا لـ توصية W3C XML 1.0.
WriteNmToken(const String&) overrideيكتب الاسم المحدد، مع التأكد من أنه NmToken صالح وفقًا لـ توصية W3C XML 1.0.
WriteProcessingInstruction(String, String) overrideيكتب تعليمًا معالجة مع مسافة بين الاسم والنص كما يلي: .
WriteQualifiedName(const String&, const String&) overrideيكتب الاسم المؤهل بالنطاق. تبحث هذه الطريقة عن البادئة المتاحة للنطاق المحدد.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideيكتب التعليمات البرمجية الخام يدويًا من مخزن مؤقت حرفي.
WriteRaw(const String&) overrideيكتب التعليمات البرمجية الخام يدويًا من سلسلة.
WriteStartAttribute(const String&, const String&, const String&) overrideيكتب بداية سمة.
WriteStartDocument() overrideيكتب إعلان XML بالإصدار “1.0”.
WriteStartDocument(bool) overrideيكتب إعلان XML بالإصدار “1.0” وخاصية standalone.
WriteStartElement(const String&, const String&, const String&) overrideيكتب علامة البداية المحددة ويربطها بالنطاق والبادئة المعطاة.
WriteString(const String&) overrideيكتب محتوى النص المعطى.
WriteSurrogateCharEntity(char16_t, char16_t) overrideينشئ ويكتب كيان حرف بديل للزوج البديل.
WriteWhitespace(String) overrideيكتب المسافة البيضاء المعطاة.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)ينشئ مثيلاً من الفئة XmlTextWriter باستخدام الدفق المحدد والترميز.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)ينشئ مثيلاً من الفئة XmlTextWriter باستخدام الملف المحدد.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)ينشئ مثيلاً من الفئة XmlTextWriter باستخدام كاتب النص المحدد.

Typedefs

تعريف نوعالوصف
Ptrاسم مستعار لمؤشر مشترك إلى مثيل من هذه الفئة.

ملاحظات

يوصى باستخدام الفئة XmlWriter بدلاً من ذلك.

يجب تخصيص كائنات هذه الفئة فقط باستخدام دالة System::MakeObject(). لا تقم أبداً بإنشاء مثيلات من هذا النوع على المكدس أو باستخدام المشغل new، حيث سيؤدي ذلك إلى أخطاء وقت التشغيل و/أو أعطال التأكيد. احرص دائماً على تغليف هذه الفئة داخل مؤشر System::SmartPtr واستخدام هذا المؤشر لتمريره إلى الدوال كمعامل.

انظر أيضًا