XmlWriter.WriteString(String) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše daný textový obsah.

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

public abstract void WriteString(string? text);

abstract member WriteString : string -> unit

Public MustOverride Sub WriteString (text As String)

Parametry

text

String

Text, který chcete napsat.

Výjimky

ArgumentException

Textový řetězec obsahuje neplatný náhradní pár.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad zapíše uzel 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

Poznámky

WriteString provede následující:

• Znaky &, <a > jsou nahrazeny &, <a >, v uvedeném pořadí.

• Výchozí chování vytvořeného XmlWriter pomocí Create je vyvolání ArgumentException při pokusu o zápis hodnot znaků v rozsahu 0x-0x1F (s výjimkou prázdných znaků 0x9, 0xA a 0xD). Tyto neplatné znaky XML lze zapsat vytvořením XmlWriter vlastnosti nastavena CheckCharacters na false. Výsledkem bude nahrazení znaků číselnými entitami znaků (� až �x1F). Kromě toho, vytvořený XmlTextWriter s new operátorem nahradí neplatné znaky číselnými znakovými entitami ve výchozím nastavení.

Poznámka Společnost Microsoft nepodporuje postup zápisu neplatných znaků XML, protože mnoho aplikací, které využívají XML, nejsou navrženy pro zpracování neplatných znaků.

• Pokud WriteString je volána v kontextu hodnoty atributu, dvojité a jednoduché uvozovky jsou nahrazeny " a ' v uvedeném pořadí.

Například tento vstupní řetězec test<item>test se zapíše jako

test<item>test

Pokud text je null nebo String.Empty, tato metoda zapíše textový uzel bez datového obsahu.

Asynchronní verzi této metody naleznete v tématu WriteStringAsync.