System::Xml::XmlReader فئة

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

انظر أيضًا