XmlTextWriter.WriteRaw Метод

Определение

Пространство имен:
System.Xml
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

Записывает необработанную разметку вручную.

Перегрузки

Имя Описание
WriteRaw(Char[], Int32, Int32)

Записывает необработанную разметку вручную из буфера символов.
WriteRaw(String)

Записывает необработанную разметку вручную из строки.

Комментарии

Note

Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.

WriteRaw(Char[], Int32, Int32)

Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs

Записывает необработанную разметку вручную из буфера символов.

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)

Параметры

buffer
Char[]

Массив символов, содержащий текст для записи.

index
Int32

Позиция в буфере, указывающая начало текста для записи.

count
Int32

Число записываемых символов.

Исключения

ArgumentNullException

buffer равно null.

ArgumentOutOfRangeException

index или count меньше нуля.

–или–

Длина буфера минус index меньше count.

Комментарии

Note

Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.

Этот метод не экранирует специальные символы.

Important

Данные XmlTextWriter , передаваемые методу WriteRaw , не проверяются. Не следует передавать произвольные данные этому методу.

Применяется к

WriteRaw(String)

Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs

Записывает необработанную разметку вручную из строки.

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)

Параметры

data
String

Строка, содержащая текст для записи.

Примеры

В следующем примере записывается строка с помощью WriteRaw метода.

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

Комментарии

Note

Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.

Этот метод не экранирует специальные символы.

Important

Данные XmlTextWriter , передаваемые методу WriteRaw , не проверяются. Не следует передавать произвольные данные этому методу.

Применяется к