System::Xml::XmlReaderSettings فئة

XmlReaderSettings class

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

class XmlReaderSettings : public System::Object

الطرق

طريقةالوصف
CheckReadOnly(const String&)
Clone()ينشئ نسخة من المثيل XmlReaderSettings.
get_CheckCharacters()يعيد قيمة تشير إلى ما إذا كان يجب إجراء فحص الأحرف.
get_CloseInput()يعيد قيمة تشير إلى ما إذا كان يجب إغلاق الدفق الأساسي أو TextReader عند إغلاق القارئ.
get_ConformanceLevel()يعيد مستوى الامتثال الذي سيتقيده XmlReader.
get_DtdProcessing()يعيد قيمة تحدد معالجة DTDs.
get_IgnoreComments()يعيد قيمة تشير إلى ما إذا كان يجب تجاهل التعليقات.
get_IgnoreProcessingInstructions()يعيد قيمة تشير إلى ما إذا كان يجب تجاهل تعليمات المعالجة.
get_IgnoreWhitespace()يعيد قيمة تشير إلى ما إذا كان يجب تجاهل المسافات البيضاء غير المهمة.
get_LineNumberOffset()يعيد إزاحة رقم السطر لكائن XmlReader.
get_LinePositionOffset()يعيد إزاحة موضع السطر لكائن XmlReader.
get_MaxCharactersFromEntities()يعيد قيمة تشير إلى الحد الأقصى المسموح لعدد الأحرف في المستند الناتجة عن توسيع الكيانات.
get_MaxCharactersInDocument()يرجع قيمة تشير إلى الحد الأقصى المسموح لعدد الأحرف في مستند XML. القيمة صفر (0) تعني عدم وجود حدود لحجم مستند XML. القيمة غير الصفرية تحدد الحد الأقصى للحجم، بالأحرف.
get_NameTable()يرجع الـ XmlNameTable المستخدم للمقارنات الذرية للسلاسل.
get_ProhibitDtd()يرجع قيمة تشير إلى ما إذا كان يجب حظر معالجة تعريف نوع المستند (DTD).
get_Schemas()يرجع الـ XmlSchemaSet لاستخدامه عند إجراء التحقق من صحة المخطط.
get_ValidationFlags()يرجع قيمة تشير إلى إعدادات التحقق من صحة المخطط. هذا الإعداد ينطبق على كائنات XmlReader التي تتحقق من صحة المخططات (قيمة XmlReaderSettings::get_ValidationType هي ValidationType::Schema).
get_ValidationType()يرجع قيمة تشير إلى ما إذا كان الـ XmlReader سيجري التحقق أو تعيين النوع أثناء القراءة.
Reset()يعيد تعيين أعضاء فئة الإعدادات إلى قيمها الافتراضية.
set_CheckCharacters(bool)يضبط قيمة تشير إلى ما إذا كان يجب إجراء فحص الأحرف.
set_CloseInput(bool)يضبط قيمة تشير إلى ما إذا كان يجب إغلاق الدفق الأساسي أو الـ TextReader عند إغلاق القارئ.
set_ConformanceLevel(System::Xml::ConformanceLevel)يضبط مستوى التوافق الذي سيتقيده الـ XmlReader.
set_DtdProcessing(System::Xml::DtdProcessing)يضبط قيمة تحدد معالجة ملفات DTD.
set_IgnoreComments(bool)يضبط قيمة تشير إلى ما إذا كان يجب تجاهل التعليقات.
set_IgnoreProcessingInstructions(bool)يضبط قيمة تشير إلى ما إذا كان يجب تجاهل تعليمات المعالجة.
set_IgnoreWhitespace(bool)يضبط قيمة تشير إلى ما إذا كان يجب تجاهل الفراغات غير المهمة.
set_LineNumberOffset(int32_t)يضبط إزاحة رقم السطر لكائن الـ XmlReader.
set_LinePositionOffset(int32_t)يضبط إزاحة موضع السطر لكائن الـ XmlReader.
set_MaxCharactersFromEntities(int64_t)يضبط قيمة تشير إلى الحد الأقصى المسموح لعدد الأحرف في مستند ناتج عن توسيع الكيانات.
set_MaxCharactersInDocument(int64_t)يضبط قيمة تشير إلى الحد الأقصى المسموح لعدد الأحرف في مستند XML. القيمة صفر (0) تعني عدم وجود حدود لحجم مستند XML. القيمة غير الصفرية تحدد الحد الأقصى للحجم، بالأحرف.
set_NameTable(const SharedPtr<XmlNameTable>&)يضبط الـ XmlNameTable المستخدم للمقارنات الذرية للسلاسل.
set_ProhibitDtd(bool)يضبط قيمة تشير إلى ما إذا كان يجب حظر معالجة تعريف نوع المستند (DTD).
set_Schemas(const SharedPtr<Schema::XmlSchemaSet>&)يضبط الـ XmlSchemaSet لاستخدامه عند إجراء التحقق من صحة المخطط.
set_ValidationFlags(Schema::XmlSchemaValidationFlags)يضبط قيمة تشير إلى إعدادات التحقق من صحة المخطط. هذا الإعداد ينطبق على كائنات XmlReader التي تتحقق من صحة المخططات (قيمة XmlReaderSettings::get_ValidationType هي ValidationType::Schema).
set_ValidationType(System::Xml::ValidationType)يضبط قيمة تشير إلى ما إذا كان الـ XmlReader سيجري التحقق أو تعيين النوع أثناء القراءة.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)يضبط الـ XmlResolver المستخدم للوصول إلى المستندات الخارجية.
ValidationEventHandler_add(Args…)يضيف معالج حدث يحدث عندما يواجه القارئ أخطاء التحقق.
ValidationEventHandler_remove(Args…)يزيل معالج حدث يحدث عندما يواجه القارئ أخطاء التحقق.
XmlReaderSettings()يُنشئ مثيلاً جديدًا من الفئة XmlReaderSettings.

Typedefs

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

ملاحظات

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

انظر أيضًا