XmlWriterSettings.NewLineHandling Propriedade

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
XmlWriterSettings.cs
Origem:
XmlWriterSettings.cs
Origem:
XmlWriterSettings.cs
Origem:
XmlWriterSettings.cs
Origem:
XmlWriterSettings.cs

Recebe ou define um valor que indica se deve normalizar quebras de linha na saída.

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

Valor de Propriedade

NewLineHandling

Um dos NewLineHandling valores. A predefinição é Replace.

Observações

Esta configuração aplica-se ao escrever conteúdo de texto ou valores de atributos. Cada um dos NewLineHandling valores é descrito abaixo:

  • A Entitize configuração indica para XmlWriter substituir novos caracteres de linha que de outra forma não seriam preservados por uma normalização XmlReader com entidades de caracteres. Isto é útil em cenários de ida e volta onde a saída é lida por um .XmlReader Regras adicionais de normalização aplicam-se para valores de atributos ao fazer round tripping, uma vez \tque , \n e \r são substituídas por um espaço nos valores dos atributos quando normalizadas num XmlReader.

  • A Replace definição indica para XmlWriter substituir os novos caracteres de linha pelos caracteres especificados na NewLineChars propriedade. Esta configuração também substitui novas linhas nos atributos por entidades de personagem para preservar as personagens. É também o valor padrão.

  • A None definição indica XmlWriter para deixar a entrada inalterada. Esta definição é usada quando não se quer qualquer processamento de novas linhas. Isto é útil quando a saída é lida por um XmlReader que não faz qualquer normalização (por exemplo, um XmlTextReader com as definições padrão).

As tabelas seguintes mostram a saída do WriteString método quando fornecida com o valor de entrada dependendo da configuração da NewLineHandling propriedade. As tabelas mostram a saída ao escrever conteúdo de texto e também ao escrever um valor de atributo.

Valor do Nó de Texto:

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

Valor do Atributo:

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

Note

Apresenta XmlWriter o seguinte comportamento ao escrever conteúdo dentro de uma secção, comentário ou instrução de processamento do CDATA. Novas linhas nunca são substituídas pelas suas entidades de carácter, mesmo quando a NewLineHandling propriedade está definida para Entitize. Isto deve-se ao facto de as entidades de carácter não serem reconhecidas nas secções, comentários ou instruções de processamento do CDATA. Se a NewLineHandling propriedade estiver definida como None ou Replace, o comportamento é o mesmo que ao escrever o valor de um nó de texto.

A tabela seguinte descreve o que uma normalização XmlReader retorna para cada entrada de espaço em branco. Para mais informações, consulte as secções 2.11 e 3.3.3 da Recomendação XML 1.0 do W3C.

Tipo de valor \r\n \n \r \t
Nó de Texto \n \n \n \t
Attribute Espaço único Espaço único Espaço único Espaço único

Note

Um leitor normalizador é qualquer XmlReader objeto criado pelo XmlReader.Create método. Estes objetos realizam sempre a normalização de quebra de linha e a normalização total dos atributos. O XmlTextReader objeto pode também ser um leitor normalizador se a sua Normalization propriedade estiver definida para true.

Aplica-se a