XmlReader.ReadElementContentAs Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

Přetížení

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

ReadElementContentAs(Type, IXmlNamespaceResolver)

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 .NET Framework 3.5 teď může být hodnota returnType parametru typemDateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

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

Návraty

Object

Obsah elementu převedený na požadovaný typovaný objekt.

Výjimky

InvalidOperationException

Není XmlReader umístěn na elementu.

-nebo-

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

XmlException

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

-nebo-

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

ArgumentNullException

Metoda se volá 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. Rozbalí entity a ignoruje pokyny a komentáře ke zpracování. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

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

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

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Zkontroluje, že zadaný místní název a identifikátor URI oboru názvů odpovídá hodnotě aktuálního elementu 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 .NET Framework 3.5 teď může být hodnota returnType parametru typemDateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

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

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

Object

Obsah elementu převedený na požadovaný typovaný objekt.

Výjimky

InvalidOperationException

Není XmlReader umístěn na elementu.

-nebo-

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

XmlException

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

-nebo-

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

ArgumentNullException

Metoda se volá s null argumenty.

ArgumentException

Zadaný místní název a identifikátor URI oboru názvů neodpovídá aktuálnímu prvku, který se čte.

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. Rozbalí entity a ignoruje pokyny a komentáře ke zpracování. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

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