XmlTextWriter.WriteRaw Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Écrit manuellement un balisage brut.

Surcharges

WriteRaw(Char[], Int32, Int32)	Écrit manuellement un balisage brut à partir d'une mémoire tampon de caractères.
WriteRaw(String)	Écrit manuellement un balisage brut à partir d'une chaîne.

Remarques

Notes

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter des instances à l’aide de la XmlWriter.Create méthode et de la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

WriteRaw(Char[], Int32, Int32)

Source:

XmlTextWriter.cs

Écrit manuellement un balisage brut à partir d'une mémoire tampon de caractères.

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)

Paramètres

buffer

Char[]

Tableau de caractères contenant le texte à écrire.

index

Int32

Emplacement dans la mémoire tampon indiquant le début du texte à écrire.

count

Int32

Nombre de caractères à écrire.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

index ou count est inférieur à zéro.

- ou -

La longueur de la mémoire tampon moins index est inférieure à count.

Remarques

Notes

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter des instances à l’aide de la XmlWriter.Create méthode et de la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Cette méthode n’échappe pas aux caractères spéciaux.

Important

ne valide pas les XmlTextWriter données passées à la WriteRaw méthode . Vous ne devez pas passer de données arbitraires à cette méthode.

WriteRaw(String)

Source:

XmlTextWriter.cs

Écrit manuellement un balisage brut à partir d'une chaîne.

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)

Paramètres

data

String

Chaîne contenant le texte à écrire.

Exemples

L’exemple suivant écrit une chaîne à l’aide de la WriteRaw méthode .

#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

Remarques

Notes

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter des instances à l’aide de la XmlWriter.Create méthode et de la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Cette méthode n’échappe pas aux caractères spéciaux.

Important

ne valide pas les XmlTextWriter données passées à la WriteRaw méthode . Vous ne devez pas passer de données arbitraires à cette méthode.