Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlWriter.WriteStartElement méthode (String, String)

 

Date de publication : novembre 2016

En cas de substitution dans une classe dérivée, écrit l’étiquette de début spécifiée et l’associe à l’espace de noms indiqué.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public void WriteStartElement(
	string localName,
	string ns
)

Paramètres

localName
Type: System.String

Le nom local de l'élément.

ns
Type: System.String

URI de l'espace de noms à associer à l'élément. Si cet espace de noms est déjà dans la portée et qu'il possède un préfixe associé, le writer écrit automatiquement ce préfixe également.

Exception Condition
InvalidOperationException

Le writer est fermé.

EncoderFallbackException

Il existe un caractère dans la mémoire tampon qui est un caractère XML valide mais n’est pas valide pour l’encodage de sortie. Par exemple, si l’encodage de sortie est ASCII, vous utilisez uniquement des caractères de la plage de 0 à 127 pour les noms d’élément et d’attribut. Le caractère non valide peut être dans l’argument de cette méthode ou dans un argument des méthodes précédentes qui écrivaient dans la mémoire tampon. Ces caractères sont ignorés par les références d’entité de caractère lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d’attribut). Toutefois, la référence d’entité de caractère n’est pas autorisée dans les noms d’éléments et d’attributs, commentaires, instructions de traitement ou les sections CDATA.

InvalidOperationException

Un XmlWriter 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. »

Après avoir appelé cette méthode, vous pouvez écrire des attributs, ou créer du contenu à l’aide de WriteComment, WriteString, ou WriteStartElement pour les éléments enfants. Vous pouvez fermer l’élément avec WriteEndElement ou WriteFullEndElement. Par exemple, le code c# suivant :

writer.WriteStartElement("item",null);
writer.WriteString("some text");
writer.WriteEndElement();

Génère la sortie suivante :

<item>some text</item>

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: