XmlWriter.WriteString(String) Метод

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)

Параметры

Исключения

Примеры

В следующем примере записывается 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

Комментарии

WriteString выполняет следующие действия:

• Символы, а затем заменяются >&<и соответственно.><&

• Поведением по умолчанию созданного XmlWriter использования Create является создание ArgumentException при попытке записи значений символов в диапазоне 0x-0x1F (за исключением символов пробелов 0x9, 0xA и 0xD). Эти недопустимые XML-символы можно записать, создав XmlWriter для свойства значение falseCheckCharacters. Это приведет к замене символов числовыми сущностями символов (� через �x1F). Кроме того, созданный с new помощью оператора, XmlTextWriter заменит недопустимые символы числовыми сущностями по умолчанию.

Примечание Корпорация Майкрософт не рекомендует писать недопустимые XML-символы, так как многие приложения, использующие XML, не предназначены для обработки недопустимых символов.

• Если WriteString вызывается в контексте значения атрибута, двойные и одинарные кавычки заменяются и "' соответственно.

Например, эта входная строка test<item>test записывается как

test<item>test

Если text это либо null , String.Emptyэтот метод записывает текстовый узел без содержимого данных.

Сведения об асинхронной версии этого метода см. в разделе WriteStringAsync.