XmlReader.ReadContentAs(Type, IXmlNamespaceResolver) Methode

public:
 virtual System::Object ^ ReadContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

public virtual object ReadContentAs(Type returnType, System.Xml.IXmlNamespaceResolver? namespaceResolver);

abstract member ReadContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parameters

Retouren

De samengevoegde tekstinhoud of kenmerkwaarde geconverteerd naar het aangevraagde type.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt de ReadContentAs methode gebruikt om de inhoud van het kleurenelement te retourneren in een matrix met tekenreeksobjecten.

using (XmlReader reader = XmlReader.Create("dataFile_2.xml")) {
      reader.ReadToDescendant("item");

      reader.MoveToAttribute("colors");
      string[] colors = (string[]) reader.ReadContentAs(typeof(string[]),null);
      foreach (string color in colors) {
         Console.WriteLine("Colors: {0}", color);
      }             		
}

Using reader As XmlReader = XmlReader.Create("dataFile_2.xml")

  reader.ReadToDescendant("item")
              
  reader.MoveToAttribute("colors")
  Dim colors As String() = CType(reader.ReadContentAs(GetType(String()), Nothing), String())
  Dim color As String
  For Each color In  colors
    Console.WriteLine("Colors: {0}", color)
  Next color
          
End Using

In het voorbeeld wordt het dataFile_2.xml bestand als invoer gebruikt.

<root>
  <item sale-item='true' productID='123456' colors='blue green black'>
    <price>9.95</price>
  </item>
  <item sale-item='false' productID='124390'>
    <price>5.95</price>
  </item>
  <item sale-item='true' productID='53298'>
    <price>12.95</price>
  </item>
</root>

Opmerkingen

Deze methode leest de tekstinhoud op de huidige positie van de lezer en converteert deze naar het aangevraagde retourtype. Tekst, witruimte, significante witruimte en CDATA-secties worden samengevoegd. Opmerkingen en verwerkingsinstructies worden overgeslagen en entiteitsverwijzingen worden automatisch opgelost.

Deze methode wordt gebruikt voor het lezen, converteren, indien nodig en het retourneren van atomische waarde-items uit de huidige knooppuntinhoud. Als het invoertype een geldige toewijzing is voor het type van het huidige knooppunt, wordt een exemplaar van het doeltype met de waarde van het huidige knooppunt geretourneerd. Zie de sectie Opmerkingen op de XmlReader referentiepagina voor een lijst met de standaardtoewijzingen.

Als u bijvoorbeeld de volgende XML-tekst hebt:

<elem>123 <!-- comment --> <?pi my_text?> 456 <?pi another_pi?></elem>

Als de gegevens worden getypt en er een tekenreeksmatrix wordt opgegeven voor de ReadContentAs methode-aanroep, worden de gehele getallen geconverteerd van tekenreeksen op basis van de lijst met geldige CLR-typetoewijzingen.

Als de gegevens niet zijn getypt en er een tekenreeksmatrix wordt geleverd aan de ReadContentAs methode-aanroep, wordt de inhoud geparseerd in afzonderlijke tekenreeksen. Een matrix met twee tekenreeksen wordt geretourneerd met de waarden 123 en 456. De spaties blijven niet behouden voor de inhoud.

Over het algemeen bij het lezen van niet-getypte gegevens wordt de inhoud geparseerd op basis van het opgegeven type. Als bijvoorbeeld een matrix met gehele getallen wordt opgegeven voor de ReadContentAs methodeaanroep, wordt de tekenreeks geparseerd in een matrix met gehele getallen {123,456}.

In het volgende voorbeeld wordt de XML-tekst niet gescheiden door spaties

<elem>123<!-- comment --><?pi my_text?>456789<?pi another_pi?></elem>

Als de inhoud niet is getypt en er een tekenreeksmatrix wordt geleverd aan de ReadContentAs methodeaanroep, wordt een matrix met één samengevoegde tekenreeks geretourneerd met de waarde '123456789'.

In de volgende tabel wordt beschreven hoe deze methode elk knooppunttype behandelt.

Zie de sectie Opmerkingen van de XmlReader referentiepagina en het W3C XML-schema deel 2: aanbeveling voor gegevenstypen voor meer informatie.

Zie voor de asynchrone versie van deze methode ReadContentAsAsync.