XmlWriterSettings.NewLineHandling Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se as quebras de linha devem ser normalizados 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, setPublic Property NewLineHandling As NewLineHandlingValor da propriedade
Um dos NewLineHandling valores. O padrão é Replace.
Comentários
Essa configuração se aplica ao escrever conteúdo de texto ou valores de atributo. Cada um dos NewLineHandling valores é descrito abaixo:
A Entitize configuração informa XmlWriter para substituir novos caracteres de linha que não seriam preservados por uma normalização XmlReader com entidades de caractere. Isso é útil em cenários de ida e volta em que a saída é lida por uma normalização XmlReader. Regras de normalização adicionais se aplicam a valores de atributo ao arredondar a remoção desde
\tentão\ne\rsão substituídas por um espaço em valores de atributo quando normalizadas em um XmlReader.A Replace configuração informa XmlWriter para substituir novos caracteres de linha pelos caracteres específicos na NewLineChars propriedade. Essa configuração também substitui novas linhas em atributos por entidades de caractere para preservar os caracteres. Também é o valor padrão.
A None configuração informa XmlWriter para deixar a entrada inalterada. Essa configuração é usada quando você não deseja nenhum processamento de nova linha. Isso é útil quando a saída é lida por um XmlReader que não faz nenhuma normalização (por exemplo, uma XmlTextReader com configurações padrão).)
As tabelas a seguir mostram a saída do WriteString método quando fornecidas 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 |
Observação
Ele XmlWriter tem o comportamento a seguir ao escrever conteúdo em uma seção cdata, comentário ou instrução de processamento. Novas linhas nunca são substituídas por suas entidades de caractere, mesmo quando a NewLineHandling propriedade é definida como Entitize. Isso ocorre porque as entidades de caractere não são reconhecidas em seções CDATA, comentários ou instruções de processamento. Se a NewLineHandling propriedade estiver definida None como ou Replace, o comportamento será o mesmo que ao escrever um valor de nó de texto.
A tabela a seguir descreve o que uma normalização XmlReader retorna para cada entrada de espaço em branco. Para obter mais informações, consulte as seções 2.11 e 3.3.3 da Recomendação W3C XML 1.0.
| 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 |
Observação
Um leitor de normalização é qualquer XmlReader objeto criado pelo XmlReader.Create método. Esses objetos sempre executam a normalização de quebra de linha e a normalização completa dos atributos. O XmlTextReader objeto também pode ser um leitor de normalização se sua Normalization propriedade estiver definida como true.
