XmlWriter.WriteString(String) Método

public:
 abstract void WriteString(System::String ^ text);

public abstract void WriteString(string text);

public abstract void WriteString(string? text);

abstract member WriteString : string -> unit

Public MustOverride Sub WriteString (text As String)

Parâmetros

Exceções

Exemplos

O exemplo a seguir grava um nó XML.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the book element.
     writer.WriteStartElement("book");

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML and close the writer.
     writer.Close();
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings)

     ' Write the book element.
     writer.WriteStartElement("book")
        
     ' Write the title element.
     writer.WriteStartElement("title")
     writer.WriteString("Pride And Prejudice")
     writer.WriteEndElement()
        
     ' Write the close tag for the root element.
     writer.WriteEndElement()
        
     ' Write the XML and close the writer.
     writer.Close()

  End Sub
End Class

Comentários

WriteString faz o seguinte:

• Os caracteres &, <e > são substituídos &por , <e >, respectivamente.

• O comportamento padrão de um XmlWriter uso Create criado é gerar um ArgumentException ao tentar gravar valores de caractere no intervalo de 0x 0x1F (excluindo caracteres de espaço em branco 0x9, 0xA e 0xD). Esses caracteres XML inválidos podem ser gravados criando com XmlWriter a CheckCharacters propriedade definida como false. Isso fará com que os caracteres sejam substituídos por entidades de caractere numérico (> até �x1F). Além disso, um XmlTextWriter criado com o new operador substituirá os caracteres inválidos por entidades de caractere numérico por padrão.

Nota A Microsoft não incentiva a prática de gravar caracteres XML inválidos, pois muitos aplicativos que consomem XML não são projetados para lidar com caracteres inválidos.

• Se WriteString for chamado no contexto de um valor de atributo, as aspas duplas e únicas serão substituídas " por e ' respectivamente.

Por exemplo, essa cadeia de caracteres de test<item>test entrada é gravada como

test<item>test

Se text for ou nullString.Empty, esse método gravará um nó de texto sem conteúdo de dados.

Para obter a versão assíncrona deste método, consulte WriteStringAsync.