XmlWriter.WriteString(String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, verilen metin içeriğini yazar.

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)

Parametreler

text

String

Yazacak metin.

Özel durumlar

ArgumentException

Metin dizesi geçersiz bir vekil çift içeriyor.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek bir XML düğümü yazar.

#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

Açıklamalar

WriteString aşağıdakileri yapar:

• , ve karakterleri &sırasıyla , <ve >ile &> değiştirilir. <

• kullanılarak Create oluşturulan bir XmlWriter öğesinin varsayılan davranışı, 0x-0x1F aralığında karakter değerleri yazmaya çalışırken bir ArgumentException oluşturmaktır (0x9, 0xA ve 0xD boşluk karakterleri hariç). Bu geçersiz XML karakterleri, özelliği olarak ayarlanmış falseşekilde oluşturularak XmlWriterCheckCharacters yazılabilir. Bunun yapılması, karakterlerin sayısal karakter varlıklarıyla (�x1F �) değiştirilmesine neden olur. Buna ek olarak, işleç ile new oluşturulan bir XmlTextWriter geçersiz karakterleri varsayılan olarak sayısal karakter varlıklarıyla değiştirir.

Not XML kullanan birçok uygulama geçersiz karakterleri işleyecek şekilde tasarlanmadığından, Microsoft geçersiz XML karakterleri yazma uygulamasını teşvik etmez.

• Öznitelik değeri bağlamında çağrılırsaWriteString, çift ve tek tırnaklar sırasıyla ve ' ile " değiştirilir.

Örneğin, bu giriş dizesi test<item>test şöyle yazılır:

test<item>test

veya String.Emptyise textnull, bu yöntem veri içeriği olmayan bir metin düğümü yazar.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStringAsync. .