XmlWriter.WriteString(String) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

派生クラスでオーバーライドされると、指定したテキスト内容を書き込みます。

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)

パラメーター

text

String

書き込むテキスト。

例外

ArgumentException

テキスト文字列に、無効なサロゲート ペアが含まれています。

InvalidOperationException

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

例

次の例では、XML ノードを書き込みます。

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create a writer to write XML to the console.
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   settings->OmitXmlDeclaration = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out, settings );
   
   // Write the book element.
   writer->WriteStartElement( L"book" );
   
   // Write the title element.
   writer->WriteStartElement( L"title" );
   writer->WriteString( L"Pride And Prejudice" );
   writer->WriteEndElement();
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML and close the writer.
   writer->Close();
   return 1;
}

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 では次の処理が行われます。

• 文字&、<、および > はそれぞれ、<および >に&置き換えられます。

• を使用してCreate作成されたXmlWriterの既定の動作では、0x-0x1F の範囲で文字値を書き込もうとしたときに がスローArgumentExceptionされます (空白文字0x9、0xA、および0xDを除きます)。 これらの無効な XML 文字は、 プロパティを にfalse設定して をXmlWriterCheckCharacters作成することで書き込むことができます。 これにより、文字が数値エンティティに置き換えられます (� から �x1F)。 さらに、 演算子でnew作成された XmlTextWriter は、無効な文字を既定で数値エンティティに置き換えます。

メモ XML を使用する多くのアプリケーションは無効な文字を処理するように設計されていないため、Microsoft は無効な XML 文字を記述する方法を推奨していません。

• が属性値のコンテキストで呼び出された場合WriteString、二重引用符と単一引用符はそれぞれ と ' に"置き換えられます。

たとえば、この入力文字列 test<item>test は として書き込まれます。

test<item>test

が または String.Emptyのnull場合text、このメソッドはデータ コンテンツのないテキスト ノードを書き込みます。

このメソッドの非同期バージョンについては、「」を参照してください WriteStringAsync。