System::Xml::XmlReader class

XmlReader class

Representerar en läsare som ger snabb, icke-cachad, framåtriktad åtkomst till XML-data.

class XmlReader : public System::IDisposable

Metoder

MetodBeskrivning
virtual Close()När den åsidosätts i en avledd klass ändras XmlReader::get_ReadState till ReadState::Closed.
static Create(const String&)Skapar en ny XmlReader instans med angiven URI.
static Create(const String&, const SharedPtr<XmlReaderSettings>&)Skapar en ny XmlReader instans genom att använda den angivna URI:n och inställningarna.
static Create(const String&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Skapar en ny XmlReader instans genom att använda den angivna URI:n, inställningarna och kontextinformationen för parsning.
static Create(const SharedPtr<IO::Stream>&)Skapar en ny XmlReader instans genom att använda den angivna strömmen med standardinställningar.
static Create(const SharedPtr<IO::Stream>&, const SharedPtr<XmlReaderSettings>&)Skapar en ny XmlReader instans med den angivna strömmen och inställningarna.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const String&)Skapar en ny XmlReader instans genom att använda den angivna strömmen, bas-URI:n och inställningarna.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Skapar en ny XmlReader instans genom att använda den angivna strömmen, inställningarna och kontextinformationen för parsning.
static Create(const SharedPtr<IO::TextReader>&)Skapar en ny XmlReader instans genom att använda den angivna textläsaren.
static Create(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlReaderSettings>&)Skapar en ny XmlReader instans genom att använda den angivna textläsaren och inställningarna.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const String&)Skapar en ny XmlReader instans genom att använda den angivna textläsaren, inställningarna och bas-URI:n.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Skapar en ny XmlReader instans genom att använda den angivna textläsaren, inställningarna och kontextinformationen för parsning.
static Create(const SharedPtr<XmlReader>&, SharedPtr<XmlReaderSettings>)Skapar en ny XmlReader instans genom att använda den angivna XML-läsaren och inställningarna.
Dispose() overrideFrigör alla resurser som används av den aktuella instansen av klassen XmlReader.
virtual get_AttributeCount()När den åsidosätts i en avledd klass, hämtar antalet attribut på den aktuella noden.
virtual get_BaseURI()När den åsidosätts i en avledd klass, hämtar bas-URI:n för den aktuella noden.
virtual get_CanReadBinaryContent()Returnerar ett värde som indikerar om XmlReader implementerar metoderna för binär innehållsläsning.
virtual get_CanReadValueChunk()Returnerar ett värde som indikerar om XmlReader implementerar metoden XmlReader::ReadValueChunk.
virtual get_CanResolveEntity()Returnerar ett värde som indikerar om denna läsare kan analysera och lösa upp entiteter.
virtual get_Depth()När den åsidosätts i en avledd klass, hämtar djupet för den aktuella noden i XML-dokumentet.
virtual get_EOF()När den åsidosätts i en avledd klass, hämtar ett värde som indikerar om läsaren är placerad i slutet av strömmen.
virtual get_HasAttributes()Returnerar ett värde som indikerar om den aktuella noden har några attribut.
virtual get_HasValue()När den åsidosätts i en avledd klass, hämtar ett värde som indikerar om den aktuella noden kan ha ett XmlReader::get_Value‑värde.
virtual get_IsDefault()När den åsidosätts i en avledd klass, hämtar ett värde som indikerar om den aktuella noden är ett attribut som genererades från standardvärdet som definierats i DTD:n eller schemat.
virtual get_IsEmptyElement()När den åsidosätts i en avledd klass, hämtar ett värde som indikerar om den aktuella noden är ett tomt element (till exempel ).
virtual get_LocalName()När den åsidosätts i en avledd klass, hämtar det lokala namnet på den aktuella noden.
virtual get_Name()När den åsidosätts i en avledd klass, hämtar det kvalificerade namnet på den aktuella noden.
virtual get_NamespaceURI()När den åsidosätts i en avledd klass, hämtar namnrymdens URI (som definierat i W3C:s namnrymdsspecifikation) för den nod som läsaren är placerad på.
virtual get_NameTable()När den åsidosätts i en avledd klass, hämtar den XmlNameTable som är associerad med denna implementation.
virtual get_NodeType()När den åsidosätts i en avledd klass, hämtar den typen av den aktuella noden.
virtual get_Prefix()När den åsidosätts i en avledd klass, hämtar den namnrymdspräfixet som är associerat med den aktuella noden.
virtual get_QuoteChar()När den åsidosätts i en avledd klass, hämtar den tecknet för citattecken som används för att omge värdet av en attributnod.
virtual get_ReadState()När den åsidosätts i en avledd klass, hämtar den läsarens tillstånd.
virtual get_SchemaInfo()Returnerar schemainformationen som har tilldelats den aktuella noden som ett resultat av schemavalidering.
virtual get_Settings()Returnerar objektet XmlReaderSettings som används för att skapa denna XmlReader-instans.
virtual get_Value()När den åsidosätts i en avledd klass, hämtar den textvärdet för den aktuella noden.
virtual get_ValueType()Returnerar typen för den aktuella noden.
virtual get_XmlLang()När den åsidosätts i en avledd klass, hämtar den aktuella xml:lang-omfånget.
virtual get_XmlSpace()När den åsidosätts i en avledd klass, hämtar den aktuella xml:space-omfånget.
virtual GetAttribute(String)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med det angivna XmlReader::get_Name-värdet.
virtual GetAttribute(String, String)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med de angivna XmlReader::get_LocalName- och XmlReader::get_NamespaceURI-värdena.
virtual GetAttribute(int32_t)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med det angivna indexet.
virtual idx_get(int32_t)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med det angivna indexet.
virtual idx_get(String)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med det angivna XmlReader::get_Name-värdet.
virtual idx_get(String, String)När den åsidosätts i en avledd klass, hämtar den värdet på attributet med de angivna XmlReader::get_LocalName- och XmlReader::get_NamespaceURI-värdena.
static IsName(const String&)Returnerar ett värde som indikerar om strängargumentet är ett giltigt XML-namn.
static IsNameToken(const String&)Returnerar ett värde som indikerar om strängargumentet är ett giltigt XML-namntoken eller inte.
virtual IsStartElement()Anropar XmlReader::MoveToContent och testar om den aktuella innehållsnoden är en starttagg eller en tom elementtagg.
virtual IsStartElement(String)Anropar XmlReader::MoveToContent och testar om den aktuella innehållsnoden är en starttagg eller en tom elementtagg samt om XmlReader::get_Name-värdet för det funna elementet matchar det givna argumentet.
virtual IsStartElement(String, String)Anropar XmlReader::MoveToContent och testar om den aktuella innehållsnoden är en starttagg eller en tom elementtagg samt om XmlReader::get_LocalName- och XmlReader::get_NamespaceURI-värdena för det funna elementet matchar de angivna strängarna.
virtual LookupNamespace(const String&)När den åsidosätts i en avledd klass, löser den ett namnrymdspräfix i det aktuella elementets omfång.
virtual MoveToAttribute(String)När den åsidosätts i en avledd klass, flyttar den till attributet med det angivna XmlReader::get_Name-värdet.
virtual MoveToAttribute(String, String)När den åsidosätts i en avledd klass, flyttar den till attributet med de angivna XmlReader::get_LocalName- och XmlReader::get_NamespaceURI-värdena.
virtual MoveToAttribute(int32_t)När den åsidosätts i en avledd klass, flyttar den till attributet med det angivna indexet.
virtual MoveToContent()Kontrollerar om den aktuella noden är en innehållsnod (icke‑blankstegstext, CDATA, Element, EndElement, EntityReference eller EndEntity). Om noden inte är en innehållsnod hoppar läsaren fram till nästa innehållsnod eller filslut. Den hoppar över noder av följande typ: ProcessingInstruction, DocumentType, Comment, Whitespace eller SignificantWhitespace.
virtual MoveToElement()När den åsidosätts i en avledd klass, flyttar den till elementet som innehåller den aktuella attributnoden.
virtual MoveToFirstAttribute()När den åsidosätts i en avledd klass, flyttas till det första attributet.
virtual MoveToNextAttribute()När den åsidosätts i en avledd klass, flyttas till nästa attribut.
virtual Read()När den åsidosätts i en avledd klass, läser nästa nod från strömmen.
virtual ReadAttributeValue()När den åsidosätts i en avledd klass, parsar attributvärdet till en eller flera Text, EntityReference eller EndEntity-noder.
virtual ReadContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Läser innehållet som ett objekt av den angivna typen.
virtual ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Läser innehållet och returnerar de Base64-dekodade binära byten.
virtual ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Läser innehållet och returnerar de BinHex‑avkodade binära bytena.
virtual ReadContentAsBoolean()Läser textinnehållet på den aktuella positionen som en Boolean.
virtual ReadContentAsDateTime()Läser textinnehållet på den aktuella positionen som ett DateTime-objekt.
virtual ReadContentAsDateTimeOffset()Läser textinnehållet på den aktuella positionen som ett DateTimeOffset-objekt.
virtual ReadContentAsDecimal()Läser textinnehållet på den aktuella positionen som ett Decimal-objekt.
virtual ReadContentAsDouble()Läser textinnehållet på den aktuella positionen som ett dubbelprecision flyttal.
virtual ReadContentAsFloat()Läser textinnehållet på den aktuella positionen som ett enkelprecision flyttal.
virtual ReadContentAsInt()Läser textinnehållet på den aktuella positionen som ett 32‑bitars signerat heltal.
virtual ReadContentAsLong()Läser textinnehållet på den aktuella positionen som ett 64‑bitars signerat heltal.
virtual ReadContentAsObject()Läser textinnehållet på den aktuella positionen som ett Object.
virtual ReadContentAsString()Läser textinnehållet på den aktuella positionen som ett String-objekt.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Läser elementets innehåll som den begärda typen.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>, String, String)Kontrollerar att det angivna lokala namnet och namnrymds‑URI:et matchar den aktuella elementet, och läser sedan elementets innehåll som den begärda typen.
virtual ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Läser elementet och avkodar Base64‑innehållet.
virtual ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Läser elementet och avkodar BinHex‑innehållet.
virtual ReadElementContentAsBoolean()Läser det aktuella elementet och returnerar innehållet som ett Boolean-objekt.
virtual ReadElementContentAsBoolean(String, String)Kontrollerar att det angivna lokala namnet och namnrymds‑URI:et matchar det aktuella elementet, och läser sedan det aktuella elementet och returnerar innehållet som ett Boolean-objekt.
virtual ReadElementContentAsDateTime()Läser det aktuella elementet och returnerar innehållet som ett DateTime-objekt.
virtual ReadElementContentAsDateTime(String, String)Kontrollerar att det angivna lokala namnet och namnrymds‑URI:et matchar det aktuella elementet, och läser sedan det aktuella elementet och returnerar innehållet som ett DateTime-objekt.
virtual ReadElementContentAsDecimal()Läser det aktuella elementet och returnerar innehållet som ett Decimal-objekt.
virtual ReadElementContentAsDecimal(String, String)Kontrollerar att det angivna lokala namnet och namnrymds‑URI:et matchar det aktuella elementet, och läser sedan det aktuella elementet och returnerar innehållet som ett Decimal-objekt.
virtual ReadElementContentAsDouble()Läser det aktuella elementet och returnerar innehållet som ett dubbelprecision flyttal.
virtual ReadElementContentAsDouble(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett dubbelprecision flyttal.
virtual ReadElementContentAsFloat()Läser det aktuella elementet och returnerar innehållet som ett enkelprecision flyttal.
virtual ReadElementContentAsFloat(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett enkelprecision flyttal.
virtual ReadElementContentAsInt()Läser det aktuella elementet och returnerar innehållet som ett 32‑bitars signerat heltal.
virtual ReadElementContentAsInt(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett 32‑bitars signerat heltal.
virtual ReadElementContentAsLong()Läser det aktuella elementet och returnerar innehållet som ett 64‑bitars signerat heltal.
virtual ReadElementContentAsLong(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett 64‑bitars signerat heltal.
virtual ReadElementContentAsObject()Läser det aktuella elementet och returnerar innehållet som ett Object.
virtual ReadElementContentAsObject(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett Object.
virtual ReadElementContentAsString()Läser det aktuella elementet och returnerar innehållet som ett String‑objekt.
virtual ReadElementContentAsString(String, String)Kontrollerar att det angivna lokala namnet och namnrymds-URI:n matchar den för det aktuella elementet, läser sedan det aktuella elementet och returnerar innehållet som ett String‑objekt.
virtual ReadElementString()Läser ett enbart text‑element. Det rekommenderas dock att använda metoden XmlReader::ReadElementContentAsString istället, eftersom den ger ett mer direkt sätt att hantera denna operation.
virtual ReadElementString(String)Kontrollerar att värdet XmlReader::get_Name för det hittade elementet matchar den angivna strängen innan ett enbart text‑element läses. Det rekommenderas dock att använda metoden XmlReader::ReadElementContentAsString istället, eftersom den ger ett mer direkt sätt att hantera denna operation.
virtual ReadElementString(String, String)Kontrollerar att värdena XmlReader::get_LocalName och XmlReader::get_NamespaceURI för det hittade elementet matchar de angivna strängarna innan ett enbart text‑element läses. Det rekommenderas dock att använda metoden XmlReader::ReadElementContentAsString istället, eftersom den ger ett mer direkt sätt att hantera denna operation.
virtual ReadEndElement()Kontrollerar att den aktuella innehållsnoden är en sluttagg och flyttar läsaren till nästa nod.
virtual ReadInnerXml()När den åsidosätts i en avledd klass läses allt innehåll, inklusive markup, som en sträng.
virtual ReadOuterXml()När den åsidosätts i en avledd klass läses innehållet, inklusive markup, som representerar denna nod och alla dess barn.
virtual ReadStartElement()Kontrollerar att den aktuella noden är ett element och flyttar läsaren till nästa nod.
virtual ReadStartElement(String)Kontrollerar att den aktuella innehållsnoden är ett element med det angivna värdet XmlReader::get_Name och flyttar läsaren till nästa nod.
virtual ReadStartElement(String, String)Kontrollerar att den aktuella innehållsnoden är ett element med de angivna värdena XmlReader::get_LocalName och XmlReader::get_NamespaceURI och flyttar läsaren till nästa nod.
virtual ReadString()När den åsidosätts i en avledd klass läses innehållet i ett element eller en textnod som en sträng. Det rekommenderas dock att använda metoden XmlReader::ReadElementContentAsString istället, eftersom den ger ett mer direkt sätt att hantera denna operation.
virtual ReadSubtree()Returnerar en ny XmlReader-instans som kan användas för att läsa den aktuella noden och alla dess undernoder.
virtual ReadToDescendant(String)Flyttar XmlReader till nästa underordnade element med det angivna kvalificerade namnet.
virtual ReadToDescendant(String, String)Flyttar XmlReader till nästa underordnade element med det angivna lokala namnet och namnrymds‑URI:n.
virtual ReadToFollowing(String)Läser tills ett element med det angivna kvalificerade namnet hittas.
virtual ReadToFollowing(String, String)Läser tills ett element med det angivna lokala namnet och namnrymds‑URI hittas.
virtual ReadToNextSibling(String)Flyttar fram XmlReader till nästa syskon‑element med det angivna kvalificerade namnet.
virtual ReadToNextSibling(String, String)Flyttar fram XmlReader till nästa syskon‑element med det angivna lokala namnet och namnrymds‑URI.
virtual ReadValueChunk(ArrayPtr<char16_t>, int32_t, int32_t)Läser stora textströmmar som är inbäddade i ett XML‑dokument.
virtual ResolveEntity()När den åsidosätts i en avledd klass, löser upp enhetsreferensen för EntityReference‑noder.
virtual Skip()Hoppar över barnen till den aktuella noden.

Typedefs

TypedefBeskrivning
PtrEtt alias för delad pekare till en instans av denna klass.

Se även