XmlWriterSettings.NewLineHandling Propriedade

Definição

Obtém ou define um valor que indica se você deseja normalizar quebras de linha na saída.Gets or sets a value indicating whether to normalize line breaks in the output.

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 da propriedade

NewLineHandling

Um dos valores de NewLineHandling.One of the NewLineHandling values. O padrão é Replace.The default is Replace.

Comentários

Essa configuração se aplica ao gravar o conteúdo de texto ou valores de atributo.This setting applies when writing text content or attribute values. Cada um dos NewLineHandling valores é descrito abaixo:Each of the NewLineHandling values is described below:

  • A Entitize configuração informa ao XmlWriter para substituir novos caracteres de linha que, de outra forma, não seriam preservados por uma normalização XmlReader com entidades de caractere.The Entitize setting tells the XmlWriter to replace new line characters that would not be otherwise preserved by a normalizing XmlReader with character entities. Isso é útil em cenários de viagem de ida e volta em que a saída é lida por uma normalização XmlReader .This is useful in round-trip scenarios where the output is read by a normalizing XmlReader. Regras de normalização adicionais se aplicam a valores de atributo quando o arredondamento é refinado desde \t \n e \r são substituídos por um espaço em valores de atributo quando normalizados em um XmlReader .Additional normalization rules apply for attribute values when round tripping since \t, \n and \r are replaced with a space in attribute values when normalized in an XmlReader.

  • A Replace configuração informa ao XmlWriter para substituir novos caracteres de linha por \r\n , que é o novo formato de linha usado pelo sistema operacional Microsoft Windows.The Replace setting tells the XmlWriter to replace new line characters with \r\n, which is the new line format used by the Microsoft Windows operating system. Isso ajuda a garantir que o arquivo possa ser exibido corretamente pelo bloco de notas ou por aplicativos do Microsoft Word.This helps to ensure that the file can be correctly displayed by the Notepad or Microsoft Word applications. Essa configuração também substitui novas linhas em atributos por entidades de caracteres para preservar os caracteres.This setting also replaces new lines in attributes with character entities to preserve the characters. Esse é o valor padrão.This is the default value.

  • A None configuração informa ao XmlWriter para deixar a entrada inalterada.The None setting tells the XmlWriter to leave the input unchanged. Essa configuração é usada quando você não deseja nenhum processamento de nova linha.This setting is used when you do not want any new-line processing. Isso é útil quando a saída é lida por um XmlReader que não faz qualquer normalização (por exemplo, um XmlTextReader com configurações padrão).This is useful when the output is read by an XmlReader that does not do any normalization (for example, an XmlTextReader with default settings.)

As tabelas a seguir mostram a saída do WriteString método quando fornecida com o valor de entrada, dependendo da NewLineHandling configuração da propriedade.The following tables show the output of the WriteString method when supplied with the input value depending on the NewLineHandling property setting. As tabelas mostram a saída ao gravar o conteúdo de texto e também ao gravar um valor de atributo.The tables show the output when writing text content and also when writing an attribute value.

Text Node Value:

\r\n\r\n \n\n \r\r \t\t
EntitizeEntitize &#D; \n&#D;\n \n\n &#D;&#D; \t\t
SubstituaReplace \r\n\r\n \r\n\r\n \r\n\r\n \t\t
NenhumNone \r\n\r\n \n\n \r\r \t\t

Attribute Value:

\r\n\r\n \n\n \r\r \t\t
EntitizeEntitize &#D;&#A;&#D;&#A; &#A;&#A; &#D;&#D; &#99	
SubstituaReplace &#D;&#A;&#D;&#A; &#A;&#A; &#D;&#D; &#99	
NenhumNone \r\n\r\n \n\n \r\r \t\t

Observação

O XmlWriter tem o seguinte comportamento ao gravar o conteúdo em uma seção CDATA, um comentário ou uma instrução de processamento.The XmlWriter has the following behavior when writing content within a CDATA section, comment, or processing instruction. Novas linhas nunca são substituídas por suas entidades de caractere, mesmo quando a NewLineHandling propriedade é definida como Entitize .New lines are never replaced with their character entities, even when the NewLineHandling property is set to Entitize. Isso ocorre porque as entidades de caractere não são reconhecidas em seções CDATA, comentários ou instruções de processamento.This is because character entities are not recognized in CDATA sections, comments or processing instructions. Se a NewLineHandling propriedade for definida como None ou Replace , o comportamento será o mesmo que ao gravar um valor de nó de texto.If the NewLineHandling property is set to None or Replace, the behavior is the same as when writing a text node value.

A tabela a seguir descreve o que uma normalização XmlReader retorna para cada entrada de espaço em branco.The following table describes what a normalizing XmlReader returns for each white space input. Para obter mais informações, consulte as seções 2,11 e 3.3.3 da recomendação do W3C XML 1,0.For more information, see sections 2.11 and 3.3.3 of the W3C XML 1.0 Recommendation.

Observação

Um leitor de normalização é qualquer XmlReader objeto criado pelo XmlReader.Create método.A normalizing reader is any XmlReader object created by the XmlReader.Create method. Esses objetos sempre executam normalização de quebra de linha e normalização completa de atributos.These objects always perform line break normalization and full normalization of attributes. O XmlTextReader objeto também pode ser um leitor de normalização se Normalization a propriedade for definida como true .The XmlTextReader object can also be a normalizing reader if it's Normalization property is set to true.

\r\n\r\n \n\n \r\r \t\t
Valor do nó de textoText Node Value \n\n \n\n \n\n \t\t
Valor do atributoAttribute Value espaço únicosingle space espaço únicosingle space espaço únicosingle space espaço únicosingle space

Aplica-se a