XmlTextWriter.WriteRaw Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Menulis markup mentah secara manual.

Overload

Nama	Deskripsi
WriteRaw(Char[], Int32, Int32)	Menulis markup mentah secara manual dari buffer karakter.
WriteRaw(String)	Menulis markup mentah secara manual dari string.

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

WriteRaw(Char[], Int32, Int32)

Sumber:

XmlTextWriter.cs

Menulis markup mentah secara manual dari buffer karakter.

public:
 override void WriteRaw(cli::array <char> ^ buffer, int index, int count);

public override void WriteRaw(char[] buffer, int index, int count);

override this.WriteRaw : char[] * int * int -> unit

Public Overrides Sub WriteRaw (buffer As Char(), index As Integer, count As Integer)

Parameter

buffer

Char[]

Array karakter yang berisi teks untuk ditulis.

index

Int32

Posisi dalam buffer yang menunjukkan awal teks untuk ditulis.

count

Int32

Jumlah karakter yang akan ditulis.

Pengecualian

ArgumentNullException

buffer adalah null.

ArgumentOutOfRangeException

index atau count kurang dari nol.

-atau-

Panjang buffer minus index kurang dari count.

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

Metode ini tidak lolos dari karakter khusus.

Important

XmlTextWriter tidak memvalidasi data apa pun yang diteruskan ke WriteRaw metode . Anda tidak boleh meneruskan data arbitrer ke metode ini.

WriteRaw(String)

Sumber:

XmlTextWriter.cs

Menulis markup mentah secara manual dari string.

public:
 override void WriteRaw(System::String ^ data);

public override void WriteRaw(string data);

override this.WriteRaw : string -> unit

Public Overrides Sub WriteRaw (data As String)

Parameter

data

String

String yang berisi teks yang akan ditulis.

Contoh

Contoh berikut menulis string menggunakan WriteRaw metode .

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

public class Sample
{
  public static void Main()
  {
     // Create a writer that outputs to the console.
     XmlTextWriter writer = new XmlTextWriter (Console.Out);
     writer.Formatting = Formatting.Indented;

     // Write the root element.
     writer.WriteStartElement("Items");

     // Write a string using WriteRaw. Note that the special
     // characters are not escaped.
     writer.WriteStartElement("Item");
     writer.WriteString("Write unescaped text:  ");
     writer.WriteRaw("this & that");
     writer.WriteEndElement();

     // Write the same string using WriteString. Note that the
     // special characters are escaped.
     writer.WriteStartElement("Item");
     writer.WriteString("Write the same string using WriteString:  ");
     writer.WriteString("this & that");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Close();
  }
}

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a writer that outputs to the console.
        Dim writer As New XmlTextWriter(Console.Out)
        writer.Formatting = Formatting.Indented
        
        ' Write the root element.
        writer.WriteStartElement("Items")
        
        ' Write a string using WriteRaw. Note that the special
        ' characters are not escaped.
        writer.WriteStartElement("Item")
        writer.WriteString("Write unescaped text:  ")
        writer.WriteRaw("this & that")
        writer.WriteEndElement()
        
        ' Write the same string using WriteString. Note that the 
        ' special characters are escaped.
        writer.WriteStartElement("Item")
        writer.WriteString("Write the same string using WriteString:  ")
        writer.WriteString("this & that")
        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

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

Metode ini tidak lolos dari karakter khusus.

Important

XmlTextWriter tidak memvalidasi data apa pun yang diteruskan ke WriteRaw metode . Anda tidak boleh meneruskan data arbitrer ke metode ini.