XmlWriter.WriteString(String) XmlWriter.WriteString(String) XmlWriter.WriteString(String) XmlWriter.WriteString(String) Method

定義

派生クラスでオーバーライドされると、指定したテキスト内容を書き込みます。When overridden in a derived class, writes the given text content.

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 String String String

書き込むテキスト。The text to write.

例外

テキスト文字列に、無効なサロゲート ペアが含まれています。The text string contains an invalid surrogate pair.

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

次の例では、XML ノードを書き込みます。The following example writes an XML node.

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

注釈

WriteString では次の処理が行われます。WriteString does the following:

  • 文字&<、および>に置き換えられます&amp;&lt;、および&gt;、それぞれします。The characters &, <, and > are replaced with &amp;, &lt;, and &gt;, respectively.

  • 既定の動作、XmlWriterを使用して作成Createをスローする、ArgumentException範囲 0 ~ 0x1f (除外の空白文字 0x9、0 xa、および 0 xd) で文字の値を記述しようとしています。The default behavior of an XmlWriter created using Create is to throw an ArgumentException when attempting to write character values in the range 0x-0x1F (excluding white space characters 0x9, 0xA, and 0xD). 無効な XML 文字を作成して書き込むことが、XmlWriterで、CheckCharactersプロパティに設定falseします。These invalid XML characters can be written by creating the XmlWriter with the CheckCharacters property set to false. 文字の数値文字エンティティに置き換えられますにそうなります ((& a)#0 から; (& a) と 0x1F)。Doing so will result in the characters being replaced with numeric character entities (&#0; through &#0x1F). さらに、XmlTextWriterで作成された、new演算子は既定では数値文字エンティティと無効な文字を置換するされます。Additionally, an XmlTextWriter created with the new operator will replace the invalid characters with numeric character entities by default.

Microsoft には、XML を使用する多くのアプリケーションが無効な文字を処理するために設計されていませんので、無効な XML 文字を書き込むことはお勧めしません。Note Microsoft does not encourage the practice of writing invalid XML characters since many applications that consume XML are not designed to handle invalid characters.

  • 場合WriteStringと呼ばれる、属性値のコンテキストでは、二重と 1 つの引用符に置き換えられます&quot;&apos;それぞれします。If WriteString is called in the context of an attribute value, double and single quotes are replaced with &quot; and &apos; respectively.

たとえば、この文字列を入力test<item>testとしての書き込みFor example, this input string test<item>test is written out as

test&lt;item&gt;test  

場合textnullまたはString.Empty、このメソッドは、データ コンテンツのないテキスト ノードを書き込みます。If text is either null or String.Empty, this method writes a text node with no data content.

このメソッドの非同期バージョンを参照してください。WriteStringAsyncします。For the asynchronous version of this method, see WriteStringAsync.

適用対象