XmlTextWriter.WriteRaw Methode

  • Referenz

Definition

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Schreibt unformatiertes Markup manuell.

Überlädt

WriteRaw(Char[], Int32, Int32)

Schreibt unformatiertes Markup manuell aus einem Zeichenpuffer.
WriteRaw(String)

Schreibt unformatiertes Markup manuell aus einer Zeichenfolge.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlWriter.Create -Methode und der XmlWriterSettings -Klasse zu erstellenXmlWriter, um die neuen Funktionen zu nutzen.

WriteRaw(Char[], Int32, Int32)

Quelle:
XmlTextWriter.cs
Quelle:
XmlTextWriter.cs
Quelle:
XmlTextWriter.cs

Schreibt unformatiertes Markup manuell aus einem Zeichenpuffer.

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[]

Zeichenarray, das den zu schreibenden Text enthält.

index
Int32

Die Position innerhalb des Puffers, die den Anfang des zu schreibenden Texts kennzeichnet.

count
Int32

Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist kleiner als 0.

- oder -

Die Pufferlänge minus index ist kleiner als count.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlWriter.Create -Methode und der XmlWriterSettings -Klasse zu erstellenXmlWriter, um die neuen Funktionen zu nutzen.

Bei dieser Methode werden keine Sonderzeichen mit Escapezeichen versehen.

Wichtig

Die XmlTextWriter überprüft keine Daten, die an die WriteRaw -Methode übergeben werden. Sie sollten keine beliebigen Daten an diese Methode übergeben.

Gilt für:

WriteRaw(String)

Quelle:
XmlTextWriter.cs
Quelle:
XmlTextWriter.cs
Quelle:
XmlTextWriter.cs

Schreibt unformatiertes Markup manuell aus einer Zeichenfolge.

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

Zeichenfolge, die den zu schreibenden Text enthält.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge mit der WriteRaw -Methode geschrieben.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create a writer that outputs to the console.
   XmlTextWriter^ writer = gcnew 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();
}

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

Hinweise

Hinweis

Ab dem .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlWriter.Create -Methode und der XmlWriterSettings -Klasse zu erstellenXmlWriter, um die neuen Funktionen zu nutzen.

Bei dieser Methode werden keine Sonderzeichen mit Escapezeichen versehen.

Wichtig

Die XmlTextWriter überprüft keine Daten, die an die WriteRaw -Methode übergeben werden. Sie sollten keine beliebigen Daten an diese Methode übergeben.

Gilt für: