System::Xml::XmlWriterSettings فئة

XmlWriterSettings class

يحدد مجموعة من الميزات لدعم كائن XmlWriter الذي تم إنشاؤه بواسطة طريقة XmlWriter::Create.

class XmlWriterSettings : public System::Object

الطرق

طريقةالوصف
Clone()ينشئ نسخة من المثيل XmlWriterSettings.
get_CheckCharacters()يرجع قيمة تشير إلى ما إذا كان كاتب XML يجب أن يتحقق لضمان أن جميع الأحرف في المستند تتطابق مع القسم “2.2 Characters” من توصية W3C XML 1.0 Recommendation.
get_CloseOutput()يرجع قيمة تشير إلى ما إذا كان يجب على XmlWriter إغلاق التدفق الأساسي أو TextWriter أيضًا عند استدعاء طريقة XmlWriter::Close.
get_ConformanceLevel()يرجع مستوى التوافق الذي يتحقق منه كاتب XML لإخراج XML.
get_DoNotEscapeUriAttributes()يرجع قيمة تشير إلى ما إذا كان XmlWriter لا يقوم بتهرب سمات URI.
get_Encoding()يرجع نوع ترميز النص لاستخدامه.
get_Indent()يرجع قيمة تشير إلى ما إذا كان يجب إزاحة العناصر.
get_IndentChars()يرجع سلسلة الأحرف المستخدمة عند الإزاحة. يتم استخدام هذا الإعداد عندما تكون قيمة XmlWriterSettings::set_Indent مضبوطة على true.
get_NamespaceHandling()يرجع قيمة تشير إلى ما إذا كان يجب على XmlWriter إزالة إعلانات النطاق المكررة عند كتابة محتوى XML. السلوك الافتراضي هو أن يقوم الكاتب بإخراج جميع إعلانات النطاق الموجودة في محلل النطاق الخاص بالكاتب.
get_NewLineChars()يرجع سلسلة الأحرف المستخدمة لفواصل الأسطر.
get_NewLineHandling()يرجع قيمة تشير إلى ما إذا كان يجب تطبيع فواصل الأسطر في الإخراج.
get_NewLineOnAttributes()يعيد قيمة تشير إلى ما إذا كان يجب كتابة السمات في سطر جديد.
get_OmitXmlDeclaration()يعيد قيمة تشير إلى ما إذا كان يجب حذف إعلان XML.
get_OutputMethod()يعيد الطريقة المستخدمة لتسلسل ناتج XmlWriter.
get_WriteEndDocumentOnClose()يعيد قيمة تشير إلى ما إذا كان XmlWriter سيضيف علامات إغلاق لجميع علامات العناصر غير المغلقة عند استدعاء طريقة XmlWriter::Close.
Reset()يعيد ضبط أعضاء فئة الإعدادات إلى القيم الافتراضية.
set_CheckCharacters(bool)يضبط قيمة تشير إلى ما إذا كان كاتب XML يجب أن يتحقق لضمان أن جميع الأحرف في المستند تتوافق مع القسم “2.2 Characters” من توصية W3C XML 1.0 Recommendation.
set_CloseOutput(bool)يضبط قيمة تشير إلى ما إذا كان XmlWriter يجب أن يغلق أيضًا الدفق الأساسي أو TextWriter عند استدعاء طريقة XmlWriter::Close.
set_ConformanceLevel(System::Xml::ConformanceLevel)يضبط مستوى التوافق الذي يتحقق منه كاتب XML في ناتج XML.
set_DoNotEscapeUriAttributes(bool)يضبط قيمة تشير إلى ما إذا كان XmlWriter لا يقوم بتهرب سمات URI.
set_Encoding(const SharedPtr<System::Text::Encoding>&)يضبط نوع ترميز النص لاستخدامه.
set_Indent(bool)يضبط قيمة تشير إلى ما إذا كان يجب إزاحة العناصر.
set_IndentChars(const String&)يضبط سلسلة الأحرف المستخدمة عند الإزاحة. يتم استخدام هذا الإعداد عندما تكون قيمة XmlWriterSettings::set_Indent مضبوطة على true.
set_NamespaceHandling(System::Xml::NamespaceHandling)يضبط قيمة تشير إلى ما إذا كان XmlWriter يجب أن يزيل إعلانات النطاق المتكررة عند كتابة محتوى XML. السلوك الافتراضي هو أن يقوم الكاتب بإخراج جميع إعلانات النطاق الموجودة في محلل النطاق الخاص بالكاتب.
set_NewLineChars(const String&)يضبط سلسلة الأحرف المستخدمة لفواصل الأسطر.
set_NewLineHandling(System::Xml::NewLineHandling)يضبط قيمة تشير إلى ما إذا كان يجب تطبيع فواصل الأسطر في الناتج.
set_NewLineOnAttributes(bool)يضبط قيمة تشير إلى ما إذا كان يجب كتابة السمات في سطر جديد.
set_OmitXmlDeclaration(bool)يضبط قيمة تشير إلى ما إذا كان يجب حذف إعلان XML.
set_WriteEndDocumentOnClose(bool)يضبط قيمة تشير إلى ما إذا كان XmlWriter سيضيف علامات إغلاق لجميع علامات العناصر غير المغلقة عند استدعاء طريقة XmlWriter::Close.
XmlWriterSettings()ينشئ نسخة جديدة من فئة XmlWriterSettings.

Typedefs

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

ملاحظات

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

انظر أيضًا