XmlReader.ReadElementContentAs Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Přečte aktuální prvek a vrátí obsah jako objekt zadaného typu.

Přetížení

Name	Description
ReadElementContentAs(Type, IXmlNamespaceResolver)	Přečte obsah elementu jako požadovaný typ.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku a pak přečte obsah elementu jako požadovaný typ.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Zdroj:

XmlReader.cs

Přečte obsah elementu jako požadovaný typ.

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

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

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

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

Parametry

returnType

Type

Typ hodnoty, která se má vrátit.

Poznámka S vydáním rozhraní .NET Framework 3.5 teď může být hodnota returnType parametru typem DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Objekt IXmlNamespaceResolver , který se používá k překladu předpon oboru názvů souvisejících s převodem typů.

Návraty

Object

Obsah elementu byl převeden na požadovaný typ objektu.

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na požadovaný typ.

ArgumentNullException

Metoda je volána s null argumenty.

OverflowException

Číst Decimal.MaxValue.

Příklady

Následující příklad používá metodu ReadElementContentAs ke čtení obsahu date uzlu.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

Příklad používá dataFile.xml soubor jako vstup.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části XmlReader Poznámky na referenční stránce a schématu W3C XML část 2: Doporučení datových typů .

Asynchronní verzi této metody naleznete v tématu ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Zdroj:

XmlReader.cs

Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku a pak přečte obsah elementu jako požadovaný typ.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

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

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parametry

returnType

Type

Typ hodnoty, která se má vrátit.

Poznámka S vydáním rozhraní .NET Framework 3.5 teď může být hodnota returnType parametru typem DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Objekt IXmlNamespaceResolver , který se používá k překladu předpon oboru názvů souvisejících s převodem typů.

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

Object

Obsah elementu byl převeden na požadovaný typ objektu.

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na požadovaný typ.

ArgumentNullException

Metoda je volána s null argumenty.

ArgumentException

Zadaný místní název a identifikátor URI oboru názvů se neshodují s aktuálním načteným elementem.

OverflowException

Číst Decimal.MaxValue.

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části XmlReader Poznámky na referenční stránce a schématu W3C XML část 2: Doporučení datových typů .