XmlReader.ReadElementContentAs Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Lit l’élément actuel et retourne le contenu en tant qu’objet du type spécifié.

Surcharges

Nom Description
ReadElementContentAs(Type, IXmlNamespaceResolver)

Lit le contenu de l’élément comme type demandé.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit le contenu de l’élément comme type demandé.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Lit le contenu de l’élément comme type demandé.

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

Paramètres

returnType
Type

Type de la valeur à renvoyer.

Note Avec la version de .NET Framework 3.5, la valeur du returnType paramètre peut maintenant être le DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver

Objet IXmlNamespaceResolver utilisé pour résoudre les préfixes d’espace de noms liés à la conversion de type.

Retours

Object

Contenu de l’élément converti en objet typé demandé.

Exceptions

InvalidOperationException

Le XmlReader paramètre n’est pas positionné sur un élément.

- ou -

Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

XmlException

L’élément actuel contient des éléments enfants.

- ou -

Le contenu de l’élément ne peut pas être converti en type demandé.

ArgumentNullException

La méthode est appelée avec null des arguments.

OverflowException

Lire Decimal.MaxValue.

Exemples

L’exemple suivant utilise la ReadElementContentAs méthode pour lire le contenu du date nœud.

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

L’exemple utilise le dataFile.xml fichier comme entrée.

<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>

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe des entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Pour plus d’informations, consultez la section Remarques de la XmlReader page de référence et la recommandation W3C XML Schema Part 2 : Datatypes .

Pour obtenir la version asynchrone de cette méthode, consultez ReadElementContentAsAsync.

S’applique à

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit le contenu de l’élément comme type demandé.

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

Paramètres

returnType
Type

Type de la valeur à renvoyer.

Note Avec la version de .NET Framework 3.5, la valeur du returnType paramètre peut maintenant être le DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver

Objet IXmlNamespaceResolver utilisé pour résoudre les préfixes d’espace de noms liés à la conversion de type.

localName
String

Nom local de l’élément.

namespaceURI
String

URI d’espace de noms de l’élément.

Retours

Object

Contenu de l’élément converti en objet typé demandé.

Exceptions

InvalidOperationException

Le XmlReader paramètre n’est pas positionné sur un élément.

- ou -

Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

XmlException

L’élément actuel contient des éléments enfants.

- ou -

Le contenu de l’élément ne peut pas être converti en type demandé.

ArgumentNullException

La méthode est appelée avec null des arguments.

ArgumentException

Le nom local et l’URI d’espace de noms spécifiés ne correspondent pas à celui de l’élément actuel lu.

OverflowException

Lire Decimal.MaxValue.

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe des entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Pour plus d’informations, consultez la section Remarques de la XmlReader page de référence et la recommandation W3C XML Schema Part 2 : Datatypes .

S’applique à