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

انظر أيضًا