XmlReader.ReadElementContentAsString 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 l'élément actuel et retourne le contenu en tant qu'objet String.
Surcharges
| ReadElementContentAsString(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 l'élément actuel et retourne le contenu en tant qu'objet String. |
| ReadElementContentAsString() |
Lit l'élément actuel et retourne le contenu en tant qu'objet String. |
ReadElementContentAsString(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 l'élément actuel et retourne le contenu en tant qu'objet String.
public:
virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);public virtual string ReadElementContentAsString (string localName, string namespaceURI);abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> stringPublic Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As StringParamètres
- localName
- String
Le nom local de l'élément.
- namespaceURI
- String
L'URI de l'espace de noms de l'élément.
Retours
Contenu de l'élément sous la forme d'un objet String.
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 -
Le contenu de l'élément ne peut pas être converti en objet String.
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.
Exemples
L’exemple suivant lit l’élément stringValue et retourne le contenu du texte (en ignorant le commentaire et l’instruction de traitement).
using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
reader.ReadToFollowing("stringValue");
Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
reader.ReadToFollowing("stringValue")
Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
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 le traitement des instructions et des 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 Schéma XML W3C Partie 2 : Types de données .
S’applique à
ReadElementContentAsString()
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
Lit l'élément actuel et retourne le contenu en tant qu'objet String.
public:
virtual System::String ^ ReadElementContentAsString();public virtual string ReadElementContentAsString ();abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> stringPublic Overridable Function ReadElementContentAsString () As StringRetours
Contenu de l'élément sous la forme d'un objet String.
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 -
Le contenu de l'élément ne peut pas être converti en objet String.
La méthode est appelée avec des arguments null.
Exemples
L’exemple suivant lit l’élément stringValue et retourne le contenu du texte (en ignorant le commentaire et l’instruction de traitement).
using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
reader.ReadToFollowing("stringValue");
Console.WriteLine(reader.ReadElementContentAsString());
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
reader.ReadToFollowing("stringValue")
Console.WriteLine(reader.ReadElementContentAsString())
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 le traitement des instructions et des 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 Schéma XML W3C Partie 2 : Types de données .
Pour obtenir la version asynchrone de cette méthode, consultez ReadElementContentAsStringAsync.
