XmlTextWriter.WriteString(String) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

XmlTextWriter.cs

指定したテキストの内容を書き込みます。

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

public override void WriteString (string? text);

override this.WriteString : string -> unit

Public Overrides Sub WriteString (text As String)

パラメーター

text

String

書き込むテキスト。

例外

ArgumentException

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

例

次の例では、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.
   XmlTextWriter^ writer = nullptr;
   writer = gcnew XmlTextWriter( Console::Out );
   
   //Use indentation for readability.
   writer->Formatting = Formatting::Indented;
   writer->Indentation = 4;
   
   //Write an element (this one is the root).
   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 to file and close the writer.
   writer->Close();
}

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

public class Sample
{

  public static void Main()
  {
     //Create a writer to write XML to the console.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     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 to file 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 writer As XmlTextWriter = Nothing
        writer = New XmlTextWriter(Console.Out)
        
        'Use indentation for readability.
        writer.Formatting = Formatting.Indented
        writer.Indentation = 4
        
        'Write an element (this one is the root).
        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 to file and close the writer.
        writer.Close()
    End Sub
End Class

注釈

注意

.NET Framework 2.0 以降では、 メソッドと クラスをXmlWriter.Create使用してインスタンスを作成XmlWriterしXmlWriterSettings、新しい機能を利用することをお勧めします。

WriteString は次の処理を行います。

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

• 0x-0x1F (空白文字0x9、0xA、0xDを除く) の文字値は、数値エンティティ (� から &#0x1F) に置き換えられます。

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

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

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