XmlWriter.WriteString メソッド

.NET Framework クラス ライブラリ リファレンス

XmlWriter.WriteString メソッド

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 WriteString ( _
    text As String _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim text As String

instance.WriteString(text)

C#

public abstract void WriteString (
    string text
)

C++

public:
virtual void WriteString (
    String^ text
) abstract

J#

public abstract void WriteString (
    String text
)

JScript

public abstract function WriteString (
    text : String
)

パラメータ

text

書き込むテキスト。

例外

例外の種類	条件
ArgumentException	テキスト文字列に、無効なサロゲート ペアが含まれています。

解説

WriteString は次を実行します。

• &、<、> の各文字は、それぞれ &amp;、&lt;、および &gt; に置き換えられます。

• 0x-0x1F (空白文字 0x9、0x10、および 0x13 を除く) の範囲内にある文字値は、数字エンティティ (&#0 から &#0x1F) に置き換えられます。

• WriteString を属性値のコンテキスト内で呼び出すと、単一引用符および二重引用符は、それぞれ &quot; と &apos; に置き換えられます。

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

 test<item>test

text が null 参照 (Visual Basic では Nothing) または String.Empty の場合、このメソッドは、データの内容を含まないテキスト ノードを書き込みます。

使用例

XML ノードを書き込む例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
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 'Main 
End Class 'Sample

C#

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();  

  }
}

C++

#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;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方