XmlReader.ReadElementContentAs Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit la valeur de l'élément en cours et retourne le contenu en tant qu'objet du type spécifié.
Surcharges
| ReadElementContentAs(Type, IXmlNamespaceResolver) |
Lit le contenu de l'élément en tant que type demandé. |
| ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) |
Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit le contenu d'élément en tant que type demandé. |
ReadElementContentAs(Type, IXmlNamespaceResolver)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
Lit le contenu de l'élément en tant que 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As ObjectParamètres
- returnType
- Type
Type de la valeur à retourner.
Remarque Avec le .NET Framework version 3.5, la valeur du paramètre returnType peut maintenant être le type DateTimeOffset.
- namespaceResolver
- IXmlNamespaceResolver
Objet IXmlNamespaceResolver permettant de résoudre tous les préfixes d'espaces de noms liés à la conversion de type.
Retours
Contenu d'élément converti en l'objet typé demandé.
Exceptions
XmlReader n'est pas placé sur un élément.
- ou -
Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
L'élément en cours contient des éléments enfants.
- ou -
Impossible de convertir le contenu de l'élément en type demandé.
La méthode est appelée avec des arguments null.
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 prend le fichier dataFile.xml 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 les 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 Notes 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
Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit le contenu d'élément en tant que 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As ObjectParamètres
- returnType
- Type
Type de la valeur à retourner.
Remarque Avec le .NET Framework version 3.5, la valeur du paramètre returnType peut maintenant être le type DateTimeOffset.
- namespaceResolver
- IXmlNamespaceResolver
Objet IXmlNamespaceResolver permettant de résoudre tous les préfixes d'espaces de noms liés à la conversion de type.
- localName
- String
Le nom local de l'élément.
- namespaceURI
- String
L'URI de l'espace de noms de l'élément.
Retours
Contenu d'élément converti en l'objet typé demandé.
Exceptions
XmlReader n'est pas placé sur un élément.
- ou -
Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
L'élément en cours contient des éléments enfants.
- ou -
Impossible de convertir le contenu de l'élément en type demandé.
La méthode est appelée avec des arguments null.
Le nom local et l'URI de l'espace de noms spécifiés ne correspondent pas à l'élément actuel lu.
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 les 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 Notes de la XmlReader page de référence et la recommandation W3C XML Schema Part 2 : Datatypes .
