Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlWriter.WriteStartElement, méthode (String, String)

En cas de substitution dans une classe dérivée, écrit la balise 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
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.

ExceptionCondition
InvalidOperationException

Le writer est fermé.

EncoderFallbackException

Un caractère dans la mémoire tampon 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 devez utiliser uniquement des caractères de la plage de 0 à 127 pour les noms d'éléments et d'attributs. 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. Les caractères de ce type sont échappé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, les commentaires, les instructions de traitement ou les sections CDATA.

InvalidOperationException

Une méthode XmlWriter 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 indiquant qu'une opération asynchrone est déjà en cours.

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

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

Génère le résultat suivant :

 <item>some text</item>

Pour la version asynchrone de la méthode, consultez l'WriteStartElementAsync.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft