Partager via


XmlWriterSettings.NewLineHandling Propriété

Définition

Obtient ou définit une valeur indiquant s'il convient de normaliser des sauts de ligne dans la sortie.

public:
 property System::Xml::NewLineHandling NewLineHandling { System::Xml::NewLineHandling get(); void set(System::Xml::NewLineHandling value); };
public System.Xml.NewLineHandling NewLineHandling { get; set; }
member this.NewLineHandling : System.Xml.NewLineHandling with get, set
Public Property NewLineHandling As NewLineHandling

Valeur de propriété

Une des valeurs de l'objet NewLineHandling. La valeur par défaut est Replace.

Remarques

Ce paramètre s’applique lors de l’écriture de contenu texte ou de valeurs d’attribut. Chacune des NewLineHandling valeurs est décrite ci-dessous :

  • Le Entitize paramètre indique au de remplacer les XmlWriter nouveaux caractères de ligne qui ne seraient pas autrement conservés par une normalisation XmlReader avec des entités de caractères. Cela est utile dans les scénarios aller-retour où la sortie est lue par un normalisateur XmlReader. Des règles de normalisation supplémentaires s’appliquent aux valeurs d’attribut lors de l’aller-retour depuis \t, \n et \r sont remplacées par un espace dans les valeurs d’attribut lorsqu’elles sont normalisées dans un XmlReader.

  • Le Replace paramètre indique au de remplacer les XmlWriter nouveaux caractères de ligne par le ou les caractères spécifiques dans la NewLineChars propriété . Ce paramètre remplace également les nouvelles lignes des attributs par des entités de caractères pour conserver les caractères. Il s’agit également de la valeur par défaut.

  • Le None paramètre indique XmlWriter au de laisser l’entrée inchangée. Ce paramètre est utilisé lorsque vous ne souhaitez pas de traitement de nouvelle ligne. Cela est utile lorsque la sortie est lue par un XmlReader qui n’effectue aucune normalisation (par exemple, un XmlTextReader avec les paramètres par défaut).)

Les tableaux suivants montrent la sortie de la WriteString méthode lorsqu’elle est fournie avec la valeur d’entrée en fonction du paramètre de propriété NewLineHandling . Les tableaux affichent la sortie lors de l’écriture du contenu texte et également lors de l’écriture d’une valeur d’attribut.

Text Node Value:

\r\n \n \r \t
Entitize &#D;\n \n &#D; \t
Replace \r\n \r\n \r\n \t
Aucun \r\n \n \r \t

Attribute Value:

\r\n \n \r \t
Entitize &#D;&#A; &#A; &#D;
Replace &#D;&#A; &#A; &#D;
Aucun \r\n \n \r \t

Notes

A XmlWriter le comportement suivant lors de l’écriture de contenu dans une section, un commentaire ou une instruction de traitement CDATA. Les nouvelles lignes ne sont jamais remplacées par leurs entités de caractères, même lorsque la propriété a la NewLineHandlingEntitizevaleur . Cela est dû au fait que les entités de caractères ne sont pas reconnues dans les sections, les commentaires ou les instructions de traitement CDATA. Si la NewLineHandling propriété a la None valeur ou Replace, le comportement est le même que lors de l’écriture d’une valeur de nœud de texte.

Le tableau suivant décrit ce qu’une normalisation XmlReader retourne pour chaque entrée d’espace blanc. Pour plus d’informations, consultez les sections 2.11 et 3.3.3 de la recommandation W3C XML 1.0.

Notes

Un lecteur de normalisation est tout XmlReader objet créé par la XmlReader.Create méthode . Ces objets effectuent toujours la normalisation de saut de ligne et la normalisation complète des attributs. L’objet XmlTextReader peut également être un lecteur de normalisation si sa Normalization propriété a la truevaleur .

\r\n \n \r \t
Valeur du nœud de texte \n \n \n \t
Valeur d'attribut espace unique espace unique espace unique espace unique

S’applique à