System::Xml::XmlReader class

XmlReader class

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

class XmlReader : public System::IDisposable

الطرق

طريقةالوصف
virtual Close()عند تجاوزها في فئة مشتقة، تغير XmlReader::get_ReadState إلى ReadState::Closed.
static Create(const String&)ينشئ مثيلًا جديدًا من XmlReader مع عنوان URI المحدد.
static Create(const String&, const SharedPtr<XmlReaderSettings>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام عنوان URI والإعدادات المحددة.
static Create(const String&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام عنوان URI والإعدادات ومعلومات السياق للتحليل.
static Create(const SharedPtr<IO::Stream>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام الدفق المحدد مع الإعدادات الافتراضية.
static Create(const SharedPtr<IO::Stream>&, const SharedPtr<XmlReaderSettings>&)ينشئ مثيلًا جديدًا من XmlReader مع الدفق المحدد والإعدادات.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const String&)ينشئ مثيلًا جديدًا من XmlReader باستخدام الدفق المحدد وعنوان URI الأساسي والإعدادات.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام الدفق المحدد والإعدادات ومعلومات السياق للتحليل.
static Create(const SharedPtr<IO::TextReader>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام قارئ النص المحدد.
static Create(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlReaderSettings>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام قارئ النص المحدد والإعدادات.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const String&)ينشئ مثيلًا جديدًا من XmlReader باستخدام قارئ النص المحدد والإعدادات وعنوان URI الأساسي.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)ينشئ مثيلًا جديدًا من XmlReader باستخدام قارئ النص المحدد والإعدادات ومعلومات السياق للتحليل.
static Create(const SharedPtr<XmlReader>&, SharedPtr<XmlReaderSettings>)ينشئ مثيلًا جديدًا من XmlReader باستخدام قارئ XML المحدد والإعدادات.
Dispose() overrideيطلق جميع الموارد المستخدمة من قبل المثيل الحالي لفئة XmlReader.
virtual get_AttributeCount()عند تجاوزها في فئة مشتقة، تُعيد عدد السمات في العقدة الحالية.
virtual get_BaseURI()عند تجاوزها في فئة مشتقة، تُعيد عنوان URI الأساسي للعقدة الحالية.
virtual get_CanReadBinaryContent()يرجع قيمة تُشير إلى ما إذا كان XmlReader يطبق طرق قراءة المحتوى الثنائي.
virtual get_CanReadValueChunk()يرجع قيمة تُشير إلى ما إذا كان XmlReader يطبق طريقة XmlReader::ReadValueChunk.
virtual get_CanResolveEntity()يعيد قيمة تشير إلى ما إذا كان هذا القارئ يستطيع تحليل الكيانات وحلها.
virtual get_Depth()عند تجاوزها في فئة مشتقة، تُعيد عمق العقدة الحالية في مستند XML.
virtual get_EOF()عند تجاوزها في فئة مشتقة، تُعيد قيمة تُشير إلى ما إذا كان القارئ في نهاية الدفق.
virtual get_HasAttributes()يعيد قيمة تشير إلى ما إذا كانت العقدة الحالية تحتوي على أي سمات.
virtual get_HasValue()عند تجاوزها في فئة مشتقة، تُعيد قيمة تُشير إلى ما إذا كان بإمكان العقدة الحالية الحصول على قيمة XmlReader::get_Value.
virtual get_IsDefault()عند تجاوزها في فئة مشتقة، تُعيد قيمة تُشير إلى ما إذا كانت العقدة الحالية سمة تم إنشاؤها من القيمة الافتراضية المعرفة في DTD أو المخطط.
virtual get_IsEmptyElement()عند تجاوزها في فئة مشتقة، تُعيد قيمة تُشير إلى ما إذا كانت العقدة الحالية عنصرًا فارغًا (على سبيل المثال، ).
virtual get_LocalName()عند تجاوزها في فئة مشتقة، تُعيد الاسم المحلي للعقدة الحالية.
virtual get_Name()عند تجاوزها في فئة مشتقة، تُعيد الاسم المؤهل للعقدة الحالية.
virtual get_NamespaceURI()عند تجاوزها في فئة مشتقة، تُعيد عنوان URI للمساحة الاسمية (كما هو معرف في مواصفة مساحة الأسماء الخاصة بـ W3C) للعقدة التي يقع عليها القارئ.
virtual get_NameTable()عند تجاوزها في فئة مشتقة، تحصل على XmlNameTable المرتبطة بهذا التنفيذ.
virtual get_NodeType()عند تجاوزها في فئة مشتقة، تحصل على نوع العقدة الحالية.
virtual get_Prefix()عند تجاوزها في فئة مشتقة، تحصل على بادئة مساحة الاسم المرتبطة بالعقدة الحالية.
virtual get_QuoteChar()عند تجاوزها في فئة مشتقة، تحصل على حرف علامة الاقتباس المستخدم لإحاطة قيمة عقدة السمة.
virtual get_ReadState()عند تجاوزها في فئة مشتقة، تحصل على حالة القارئ.
virtual get_SchemaInfo()يعيد معلومات المخطط التي تم تعيينها للعقدة الحالية نتيجةً للتحقق من صحة المخطط.
virtual get_Settings()يعيد كائن XmlReaderSettings المستخدم لإنشاء هذه المثيلة من XmlReader.
virtual get_Value()عند تجاوزها في فئة مشتقة، تحصل على القيمة النصية للعقدة الحالية.
virtual get_ValueType()يعيد النوع للعقدة الحالية.
virtual get_XmlLang()عند تجاوزها في فئة مشتقة، تحصل على نطاق xml:lang الحالي.
virtual get_XmlSpace()عند تجاوزها في فئة مشتقة، تحصل على نطاق xml:space الحالي.
virtual GetAttribute(String)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات القيمة المحددة لـ XmlReader::get_Name.
virtual GetAttribute(String, String)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات القيم المحددة لـ XmlReader::get_LocalName و XmlReader::get_NamespaceURI.
virtual GetAttribute(int32_t)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات الفهرس المحدد.
virtual idx_get(int32_t)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات الفهرس المحدد.
virtual idx_get(String)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات القيمة المحددة لـ XmlReader::get_Name.
virtual idx_get(String, String)عند تجاوزها في فئة مشتقة، تحصل على قيمة السمة ذات القيم المحددة لـ XmlReader::get_LocalName و XmlReader::get_NamespaceURI.
static IsName(const String&)يعيد قيمة تشير إلى ما إذا كان معامل السلسلة نصًا صالحًا كاسم XML.
static IsNameToken(const String&)يعيد قيمة تشير إلى ما إذا كان معامل السلسلة نصًا صالحًا كرمز اسم XML أم لا.
virtual IsStartElement()ينادي XmlReader::MoveToContent ويختبر ما إذا كانت عقدة المحتوى الحالية علامة بدء أو علامة عنصر فارغ.
virtual IsStartElement(String)ينادي XmlReader::MoveToContent ويختبر ما إذا كانت عقدة المحتوى الحالية علامة بدء أو علامة عنصر فارغ وما إذا كانت قيمة XmlReader::get_Name للعنصر الموجود تطابق الوسيط المعطى.
virtual IsStartElement(String, String)ينادي XmlReader::MoveToContent ويختبر ما إذا كانت عقدة المحتوى الحالية علامة بدء أو علامة عنصر فارغ وما إذا كانت قيم XmlReader::get_LocalName و XmlReader::get_NamespaceURI للعنصر الموجود تطابق السلاسل المعطاة.
virtual LookupNamespace(const String&)عند تجاوزها في فئة مشتقة، تحلّ بادئة مساحة الاسم في نطاق العنصر الحالي.
virtual MoveToAttribute(String)عند تجاوزها في فئة مشتقة، ينتقل إلى السمة ذات القيمة المحددة لـ XmlReader::get_Name.
virtual MoveToAttribute(String, String)عند تجاوزها في فئة مشتقة، ينتقل إلى السمة ذات القيم المحددة لـ XmlReader::get_LocalName و XmlReader::get_NamespaceURI.
virtual MoveToAttribute(int32_t)عند تجاوزها في فئة مشتقة، ينتقل إلى السمة ذات الفهرس المحدد.
virtual MoveToContent()يتحقق مما إذا كانت العقدة الحالية عقدة محتوى (نص غير مساحة بيضاء، CDATA, Element, EndElement, EntityReference, أو EndEntity). إذا لم تكن العقدة عقدة محتوى، يتخطى القارئ إلى العقدة المحتوى التالية أو إلى نهاية الملف. يتخطى العقد من الأنواع التالية: ProcessingInstruction, DocumentType, Comment, Whitespace, أو SignificantWhitespace.
virtual MoveToElement()عند تجاوزها في فئة مشتقة، ينتقل إلى العنصر الذي يحتوي على عقدة السمة الحالية.
virtual MoveToFirstAttribute()عند تجاوزها في فئة مشتقة، تنتقل إلى السمة الأولى.
virtual MoveToNextAttribute()عند تجاوزها في فئة مشتقة، تنتقل إلى السمة التالية.
virtual Read()عند تجاوزها في فئة مشتقة، تقرأ العقدة التالية من الدفق.
virtual ReadAttributeValue()عند تجاوزها في فئة مشتقة، تحلل قيمة السمة إلى واحد أو أكثر من عقد Text، EntityReference، أو EndEntity.
virtual ReadContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)يقرأ المحتوى ككائن من النوع المحدد.
virtual ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)يقرأ المحتوى ويعيد بايتات ثنائية مُفكّكة من Base64.
virtual ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)يقرأ المحتوى ويرجع البايتات الثنائية المفكوكة من BinHex.
virtual ReadContentAsBoolean()يقرأ محتوى النص في الموضع الحالي كـ Boolean.
virtual ReadContentAsDateTime()يقرأ محتوى النص في الموضع الحالي ككائن DateTime.
virtual ReadContentAsDateTimeOffset()يقرأ محتوى النص في الموضع الحالي ككائن DateTimeOffset.
virtual ReadContentAsDecimal()يقرأ محتوى النص في الموضع الحالي ككائن Decimal.
virtual ReadContentAsDouble()يقرأ محتوى النص في الموضع الحالي كعدد عائم مزدوج الدقة.
virtual ReadContentAsFloat()يقرأ محتوى النص في الموضع الحالي كعدد عائم أحادي الدقة.
virtual ReadContentAsInt()يقرأ محتوى النص في الموضع الحالي كعدد صحيح موقّع 32‑بت.
virtual ReadContentAsLong()يقرأ محتوى النص في الموضع الحالي كعدد صحيح موقّع 64‑بت.
virtual ReadContentAsObject()يقرأ محتوى النص في الموضع الحالي كـ Object.
virtual ReadContentAsString()يقرأ محتوى النص في الموضع الحالي ككائن String.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)يقرأ محتوى العنصر كالنوع المطلوب.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>, String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ محتوى العنصر كالنوع المطلوب.
virtual ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)يقرأ العنصر ويفكّ تشفير محتوى Base64.
virtual ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)يقرأ العنصر ويفكّ تشفير محتوى BinHex.
virtual ReadElementContentAsBoolean()يقرأ العنصر الحالي ويعيد المحتويات ككائن Boolean.
virtual ReadElementContentAsBoolean(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتويات ككائن Boolean.
virtual ReadElementContentAsDateTime()يقرأ العنصر الحالي ويعيد المحتويات ككائن DateTime.
virtual ReadElementContentAsDateTime(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتويات ككائن DateTime.
virtual ReadElementContentAsDecimal()يقرأ العنصر الحالي ويعيد المحتويات ككائن Decimal.
virtual ReadElementContentAsDecimal(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتويات ككائن Decimal.
virtual ReadElementContentAsDouble()يقرأ العنصر الحالي ويعيد المحتويات كعدد عائم مزدوج الدقة.
virtual ReadElementContentAsDouble(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى كعدد عائم بدقة مزدوجة.
virtual ReadElementContentAsFloat()يقرأ العنصر الحالي ويعيد المحتوى كعدد عائم بدقة مفردة.
virtual ReadElementContentAsFloat(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى كعدد عائم بدقة مفردة.
virtual ReadElementContentAsInt()يقرأ العنصر الحالي ويعيد المحتوى كعدد صحيح موقع 32‑بت.
virtual ReadElementContentAsInt(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى كعدد صحيح موقع 32‑بت.
virtual ReadElementContentAsLong()يقرأ العنصر الحالي ويعيد المحتوى كعدد صحيح موقع 64‑بت.
virtual ReadElementContentAsLong(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى كعدد صحيح موقع 64‑بت.
virtual ReadElementContentAsObject()يقرأ العنصر الحالي ويعيد المحتوى كـ Object.
virtual ReadElementContentAsObject(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى كـ Object.
virtual ReadElementContentAsString()يقرأ العنصر الحالي ويعيد المحتوى ككائن String.
virtual ReadElementContentAsString(String, String)يتحقق من أن الاسم المحلي المحدد ومسار URI للمساحة الاسمية يطابقان العنصر الحالي، ثم يقرأ العنصر الحالي ويعيد المحتوى ككائن String.
virtual ReadElementString()يقرأ عنصرًا نصيًا فقط. ومع ذلك، يُنصح باستخدام طريقة XmlReader::ReadElementContentAsString بدلاً من ذلك، لأنها توفر طريقة أكثر بساطة للتعامل مع هذه العملية.
virtual ReadElementString(String)يتحقق من أن قيمة XmlReader::get_Name للعنصر الموجود تطابق السلسلة المعطاة قبل قراءة عنصر نصي فقط. ومع ذلك، يُنصح باستخدام طريقة XmlReader::ReadElementContentAsString بدلاً من ذلك، لأنها توفر طريقة أكثر بساطة للتعامل مع هذه العملية.
virtual ReadElementString(String, String)يتحقق من أن قيمتي XmlReader::get_LocalName وXmlReader::get_NamespaceURI للعنصر الموجود تطابق السلاسل المعطاة قبل قراءة عنصر نصي فقط. ومع ذلك، يُنصح باستخدام طريقة XmlReader::ReadElementContentAsString بدلاً من ذلك، لأنها توفر طريقة أكثر بساطة للتعامل مع هذه العملية.
virtual ReadEndElement()يتحقق من أن عقدة المحتوى الحالية هي علامة إغلاق ويُقدِّم القارئ إلى العقدة التالية.
virtual ReadInnerXml()عند تجاوزها في فئة مشتقة، تقرأ كل المحتوى، بما في ذلك العلامات، كسلسلة نصية.
virtual ReadOuterXml()عند تجاوزها في فئة مشتقة، تقرأ المحتوى، بما في ذلك العلامات، التي تمثل هذه العقدة وجميع أبنائها.
virtual ReadStartElement()يتحقق من أن العقدة الحالية عنصر ويُقدِّم القارئ إلى العقدة التالية.
virtual ReadStartElement(String)يتحقق من أن عقدة المحتوى الحالية عنصر يحمل القيمة XmlReader::get_Name المعطاة ويُقدِّم القارئ إلى العقدة التالية.
virtual ReadStartElement(String, String)يتحقق من أن عقدة المحتوى الحالية عنصر يحمل القيمتين XmlReader::get_LocalName وXmlReader::get_NamespaceURI المعطاة ويُقدِّم القارئ إلى العقدة التالية.
virtual ReadString()عند تجاوزها في فئة مشتقة، تقرأ محتويات عنصر أو عقدة نصية كسلسلة نصية. ومع ذلك، يُنصح باستخدام طريقة XmlReader::ReadElementContentAsString بدلاً من ذلك، لأنها توفر طريقة أكثر بساطة للتعامل مع هذه العملية.
virtual ReadSubtree()يعيد نسخة جديدة من XmlReader يمكن استخدامها لقراءة العقدة الحالية وجميع فروعها.
virtual ReadToDescendant(String)يُقدِّم XmlReader إلى العنصر السليل التالي الذي يحمل الاسم المؤهل المحدد.
virtual ReadToDescendant(String, String)يُقدِّم XmlReader إلى العنصر السليل التالي الذي يحمل الاسم المحلي ومسار URI للمساحة الاسمية المحددين.
virtual ReadToFollowing(String)يقرأ حتى يتم العثور على عنصر يحمل الاسم المؤهل المحدد.
virtual ReadToFollowing(String, String)يقرأ حتى يتم العثور على عنصر بالاسم المحلي المحدد ومسار مساحة الاسم URI.
virtual ReadToNextSibling(String)يتقدم بـ XmlReader إلى العنصر الشقيق التالي بالاسم المؤهل المحدد.
virtual ReadToNextSibling(String, String)يتقدم بـ XmlReader إلى العنصر الشقيق التالي بالاسم المحلي المحدد ومسار مساحة الاسم URI.
virtual ReadValueChunk(ArrayPtr<char16_t>, int32_t, int32_t)يقرأ تدفقات نصية كبيرة مدمجة في مستند XML.
virtual ResolveEntity()عند تجاوزها في فئة مشتقة، تحل إشارة الكيان لعقد EntityReference.
virtual Skip()يتخطى أبناء العقدة الحالية.

Typedefs

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

انظر أيضًا