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이 throw됩니다.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.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 throw 하는 것을 ArgumentException 범위 0-0x1f (공백 문자 0x9, 0xA 및 0xD)에서 문자 값을 작성 하려고 할 때입니다.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. 그렇게 하면 숫자 엔터티로 대체 되는 문자에서 (&#0 통해; & #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 라고 특성 값의 컨텍스트에서 사용 하 여 큰따옴표와 작은따옴표 바뀝니다 &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  

경우 text 중 하나는 null 또는 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.

적용 대상