فئة System::Xml::XmlTextReader

XmlTextReader class

يمثل قارئًا يوفر وصولًا سريعًا غير مخزن مؤقتًا إلى بيانات XML.

class XmlTextReader : public System::Xml::XmlReader,
                      public System::Xml::IXmlLineInfo,
                      public System::Xml::IXmlNamespaceResolver

الطرق

طريقةالوصف
Close() overrideيغيّر الـ XmlReader::get_ReadState إلى Closed.
get_AttributeCount() overrideيعيد عدد السمات في العقدة الحالية.
get_BaseURI() overrideيعيد عنوان URI الأساسي للعقدة الحالية.
get_CanReadBinaryContent() overrideيرجع قيمة تشير إلى ما إذا كان الـ XmlTextReader يطبق طرق قراءة المحتوى الثنائي.
get_CanReadValueChunk() overrideيرجع قيمة تشير إلى ما إذا كان الـ XmlTextReader يطبق طريقة XmlReader::ReadValueChunk.
get_CanResolveEntity() overrideيعيد قيمة تشير إلى ما إذا كان هذا القارئ يستطيع تحليل الكيانات وحلها.
get_Depth() overrideيعيد عمق العقدة الحالية في مستند XML.
get_DtdProcessing()يرجع تعداد DtdProcessing.
get_Encoding()يرجع ترميز المستند.
get_EntityHandling()يرجع قيمة تحدد كيفية تعامل القارئ مع الكيانات.
get_EOF() overrideيعيد قيمة تشير إلى ما إذا كان القارئ في موضع نهاية الدفق.
get_HasValue() overrideيرجع قيمة تشير إلى ما إذا كان العقدة الحالية يمكن أن تحتوي على XmlTextReader::get_Value غير String::Empty.
get_IsDefault() overrideيرجع قيمة تشير إلى ما إذا كانت العقدة الحالية سمة تم إنشاؤها من القيمة الافتراضية المعرفة في DTD أو المخطط.
get_IsEmptyElement() overrideيعيد قيمة تشير إلى ما إذا كانت العقدة الحالية عنصرًا فارغًا (على سبيل المثال، ).
get_LineNumber() overrideيرجع رقم السطر الحالي.
get_LinePosition() overrideيرجع موضع السطر الحالي.
get_LocalName() overrideيرجع الاسم المحلي للعقدة الحالية.
get_Name() overrideيعيد الاسم المؤهل للعقدة الحالية.
get_Namespaces()يعيد قيمة تشير إلى ما إذا كان يجب دعم المساحات الاسمية.
get_NamespaceURI() overrideيعيد URI مساحة الاسم (كما هو معرف في مواصفة مساحة الاسم الخاصة بـ W3C) للعقدة التي يقع عليها القارئ.
get_NameTable() overrideيعيد XmlNameTable المرتبط بهذا التنفيذ.
get_NodeType() overrideيرجع نوع العقدة الحالية.
get_Normalization()يرجع قيمة تشير إلى ما إذا كان يجب تطبيع المسافات الفارغة وقيم السمات.
get_Prefix() overrideيعيد بادئة مساحة الاسم المرتبطة بالعقدة الحالية.
get_ProhibitDtd()يرجع قيمة تشير إلى ما إذا كان يجب السماح بمعالجة DTD.
get_QuoteChar() overrideيرجع حرف علامة الاقتباس المستخدم لتغليف قيمة عقدة السمة.
get_ReadState() overrideيعيد حالة القارئ.
get_Value() overrideيعيد القيمة النصية للعقدة الحالية.
get_WhitespaceHandling()يرجع قيمة تحدد كيفية معالجة المسافات الفارغة.
get_XmlLang() overrideيعيد نطاق xml:lang الحالي.
get_XmlSpace() overrideيعيد نطاق xml:space الحالي.
GetAttribute(String) overrideيعيد قيمة السمة ذات الاسم المحدد.
GetAttribute(String, String) overrideيعيد قيمة السمة ذات الاسم المحلي المحدد وURI مساحة الاسم.
GetAttribute(int32_t) overrideيعيد قيمة السمة ذات الفهرس المحدد.
GetNamespacesInScope(XmlNamespaceScope) overrideيرجع مجموعة تحتوي على جميع النطاقات الحالية في النطاق.
GetRemainder()يرجع باقي XML المخزن في الذاكرة المؤقتة.
HasLineInfo() overrideيرجع قيمة تشير إلى ما إذا كان الصنف يمكنه إرجاع معلومات السطر.
LookupNamespace(const String&) overrideيحلّ بادئة مساحة الاسم في نطاق العنصر الحالي.
MoveToAttribute(String) overrideينتقل إلى السمة ذات الاسم المحدد.
MoveToAttribute(String, String) overrideينتقل إلى السمة ذات الاسم المحلي المحدد وURI مساحة الاسم.
MoveToAttribute(int32_t) overrideينتقل إلى السمة ذات الفهرس المحدد.
MoveToElement() overrideينتقل إلى العنصر الذي يحتوي على عقدة السمة الحالية.
MoveToFirstAttribute() overrideينتقل إلى السمة الأولى.
MoveToNextAttribute() overrideينتقل إلى السمة التالية.
Read() overrideيقرأ العقدة التالية من الدفق.
ReadAttributeValue() overrideيقوم بتحليل قيمة السمة إلى واحد أو أكثر من Text، EntityReference، أو EndEntity العقد.
ReadBase64(const ArrayPtr<uint8_t>&, int32_t, int32_t)يفكّ تشفير Base64 ويرجع البايتات الثنائية المفكوكة.
ReadBinHex(const ArrayPtr<uint8_t>&, int32_t, int32_t)يفكّ تشفير BinHex ويرجع البايتات الثنائية المفكوكة.
ReadChars(const ArrayPtr<char16_t>&, int32_t, int32_t)يقرأ محتوى النص لعنصر إلى مخزن أحرف. تم تصميم هذه الطريقة لقراءة تدفقات نصية مدمجة كبيرة عن طريق استدعائها بشكل متتابع.
ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقرأ المحتوى ويرجع البايتات الثنائية المفكوكة من Base64.
ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقرأ المحتوى ويرجع البايتات الثنائية المفكوكة من BinHex.
ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقرأ العنصر ويفكّك محتوى Base64.
ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideيقرأ العنصر ويفكّ تشفير محتوى BinHex.
ReadString() overrideيقرأ محتويات عنصر أو عقدة نصية كسلسلة.
ResetState()يعيد ضبط حالة القارئ إلى ReadState::Initial.
ResolveEntity() overrideيحل مرجع الكيان لعقد EntityReference.
set_DtdProcessing(System::Xml::DtdProcessing)يضبط تعداد DtdProcessing.
set_EntityHandling(System::Xml::EntityHandling)يضبط قيمة تحدد كيفية تعامل القارئ مع الكيانات.
set_Namespaces(bool)يضبط قيمة تشير إلى ما إذا كان سيتم دعم النطاقات.
set_Normalization(bool)يضبط قيمة تشير إلى ما إذا كان يجب تطبيع الفراغات وقيم السمات.
set_ProhibitDtd(bool)يضبط قيمة تشير إلى ما إذا كان يُسمح بمعالجة DTD.
set_WhitespaceHandling(System::Xml::WhitespaceHandling)يضبط قيمة تحدد كيفية معالجة الفراغات.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)يضبط الـ XmlResolver المستخدم لحل مراجع DTD.
Skip() overrideيتخطى أبناء العقدة الحالية.
XmlTextReader(const SharedPtr<IO::Stream>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الدفق المحدد.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام عنوان URL والدفق المحدد.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الدفق وXmlNameTable المحددين.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام عنوان URL والدفق وXmlNameTable المحددين.
XmlTextReader(const SharedPtr<IO::TextReader>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الـ TextReader المحدد.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام عنوان URL والـ TextReader المحددين.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الـ TextReader وXmlNameTable المحددين.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام عنوان URL والـ TextReader وXmlNameTable المحددين.
XmlTextReader(const SharedPtr<IO::Stream>&, XmlNodeType, const SharedPtr<XmlParserContext>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الدفق، XmlNodeType، وXmlParserContext.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام السلسلة، XmlNodeType، وXmlParserContext.
XmlTextReader(const String&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الملف المحدد.
XmlTextReader(const String&, const SharedPtr<XmlNameTable>&)ينشئ نسخة جديدة من الفئة XmlTextReader باستخدام الملف وXmlNameTable المحددين.

Typedefs

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

ملاحظات

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

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

انظر أيضًا