فئة 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 واستخدام هذا المؤشر لتمريره إلى الدوال كمعامل.

انظر أيضًا