XmlTextWriter.WriteRaw Methode

Definitie

Naamruimte:
System.Xml
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Schrijft onbewerkte opmaak handmatig.

Overloads

Name Description
WriteRaw(Char[], Int32, Int32)

Schrijft onbewerkte markeringen handmatig vanuit een tekenbuffer.
WriteRaw(String)

Schrijft onbewerkte markeringen handmatig uit een tekenreeks.

Opmerkingen

Note

U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.

WriteRaw(Char[], Int32, Int32)

Schrijft onbewerkte markeringen handmatig vanuit een tekenbuffer.

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)

Parameters

buffer
Char[]

Tekenmatrix met de tekst die moet worden geschreven.

index
Int32

De positie in de buffer die het begin van de te schrijven tekst aangeeft.

count
Int32

Het aantal tekens dat moet worden geschreven.

Uitzonderingen

ArgumentNullException

buffer is null.

ArgumentOutOfRangeException

index of count kleiner is dan nul.

– of –

De bufferlengte min index is kleiner dan count.

Opmerkingen

Note

U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.

Deze methode escapet geen speciale tekens.

Important

Hiermee XmlTextWriter worden geen gegevens gevalideerd die aan de WriteRaw methode worden doorgegeven. U mag geen willekeurige gegevens doorgeven aan deze methode.

Van toepassing op

WriteRaw(String)

Schrijft onbewerkte markeringen handmatig uit een tekenreeks.

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)

Parameters

data
String

Tekenreeks die de te schrijven tekst bevat.

Voorbeelden

In het volgende voorbeeld wordt een tekenreeks geschreven met behulp van de WriteRaw methode.

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

Opmerkingen

Note

U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.

Deze methode escapet geen speciale tekens.

Important

Hiermee XmlTextWriter worden geen gegevens gevalideerd die aan de WriteRaw methode worden doorgegeven. U mag geen willekeurige gegevens doorgeven aan deze methode.

Van toepassing op