Partager via

XmlWriterSettings.NewLineHandling Propriété

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
XmlWriterSettings.cs
Source:
XmlWriterSettings.cs
Source:
XmlWriterSettings.cs
Source:
XmlWriterSettings.cs
Source:
XmlWriterSettings.cs

Obtient ou définit une valeur indiquant s’il faut normaliser les 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é

NewLineHandling

Une des NewLineHandling valeurs. La valeur par défaut est Replace.

Remarques

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

  • Le Entitize paramètre indique à remplacer les XmlWriter nouveaux caractères de ligne qui ne seraient pas autrement conservés par une normalisation XmlReader par des entités de caractères. Cela est utile dans les scénarios d’aller-retour où la sortie est lue par une normalisation 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 à XmlWriter remplacer les nouveaux caractères de ligne par les caractères spécifiques de la NewLineChars propriété. Ce paramètre remplace également les nouvelles lignes dans les 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 de laisser l’entrée XmlWriter 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 ne fait aucune normalisation (par exemple, un XmlTextReader avec des paramètres par défaut.)

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

Valeur du nœud texte :

NewLineHandling \r\n \n \r \t
Entitize &#D ;\n \n &#D ; \t
Replace \r\n \r\n \r\n \t
None \r\n \n \r \t

Valeur de l’attribut :

NewLineHandling \r\n \n \r \t
Entitize &#D ;&#A ; &#A ; &#D ;  ;
Replace &#D ;&#A ; &#A ; &#D ;  ;
None \r\n \n \r \t

Note

Le XmlWriter comportement suivant se produit 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 NewLineHandling propriété est définie Entitizesur . Cela est dû au fait que les entités de caractères ne sont pas reconnues dans les sections CDATA, les commentaires ou les instructions de traitement. Si la propriété est définie None ou Replace, le comportement est le même que lors de l’écriture NewLineHandling 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.

Type de valeur \r\n \n \r \t
Nœud de texte \n \n \n \t
Caractéristique espace unique espace unique espace unique espace unique

Note

Un lecteur de normalisation est n’importe quel XmlReader objet créé par la XmlReader.Create méthode. Ces objets effectuent toujours une normalisation de saut de ligne et une normalisation complète des attributs. L’objet XmlTextReader peut également être un lecteur de normalisation si sa Normalization propriété est définie sur true.

S’applique à