XmlWriter.Create Méthode

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings? settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings settings);

static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant crée un XmlWriter objet avec les paramètres définis.

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

public class Sample {

  public static void Main() {

    XmlWriter writer = null;

    try {

       // Create an XmlWriterSettings object with the correct options.
       XmlWriterSettings settings = new XmlWriterSettings();
       settings.Indent = true;
       settings.IndentChars = ("\t");
       settings.OmitXmlDeclaration = true;

       // Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings);
       writer.WriteStartElement("book");
       writer.WriteElementString("item", "tesing");
       writer.WriteEndElement();
    
       writer.Flush();
     }
     finally  {
        if (writer != null)
          writer.Close();
     }
  }
}

Imports System.IO
Imports System.Xml
Imports System.Text

Public Class Sample 

  Public Shared Sub Main() 
  
    Dim writer As XmlWriter = Nothing

    Try 

       ' Create an XmlWriterSettings object with the correct options. 
       Dim settings As XmlWriterSettings = New XmlWriterSettings()
       settings.Indent = true
       settings.IndentChars = (ControlChars.Tab)
       settings.OmitXmlDeclaration = true

       ' Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings)
       writer.WriteStartElement("book")
       writer.WriteElementString("item", "tesing")
       writer.WriteEndElement()
    
       writer.Flush()

      Finally
         If Not (writer Is Nothing) Then
            writer.Close()
         End If
      End Try

   End Sub 
End Class

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant écrit une chaîne XML.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();

using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();

    String output = sw.ToString();
}

Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
        
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
            
  Dim output As String = sw.ToString()
End Using

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant écrit un fragment XML dans un flux de mémoire.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

Remarques

XmlWriter écrit toujours une marque d’ordre d’octet (BOM) dans le flux de données sous-jacent ; toutefois, certains flux ne doivent pas avoir de boM. Pour omettre le boM, créez un XmlWriterSettings objet et définissez la propriété Encoding comme un nouvel UTF8Encoding objet avec la valeur booléenne dans le constructeur défini sur false.

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter autour de l'objet XmlWriter spécifié.

Exceptions

Remarques

Cette méthode vous permet d’ajouter des fonctionnalités supplémentaires à un objet sous-jacent XmlWriter . L’objet sous-jacent XmlWriter peut être un objet créé par la XmlWriter.Create méthode ou un objet créé à l’aide de l’implémentation XmlTextWriter .

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output);

static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Remarques

Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec des paramètres par défaut est utilisé pour créer l’enregistreur XML.

Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un XmlWriterSettings objet comme l’un de ses arguments et transmettez un XmlWriterSettings objet avec vos paramètres personnalisés.

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);

public static System.Xml.XmlWriter Create (string outputFileName);

static member Create : string -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant crée un XmlWriter objet et écrit un nœud de livre.

using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create("output.xml")
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

Remarques

Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec des paramètres par défaut est utilisé pour créer l’enregistreur XML.

Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un objet comme l’un XmlWriterSettings de ses arguments et transmettez un XmlWriterSettings objet avec vos paramètres personnalisés.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output);

static member Create : System.IO.TextWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant crée un enregistreur qui s’affiche dans la console.

using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create(Console.Out)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

Remarques

Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec des paramètres par défaut est utilisé pour créer l’enregistreur XML.

Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur créé, utilisez une surcharge qui prend un objet comme l’un XmlWriterSettings de ses arguments et transmettez un XmlWriterSettings objet avec vos paramètres personnalisés.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);

public static System.Xml.XmlWriter Create (System.IO.Stream output);

static member Create : System.IO.Stream -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter.

Exceptions

Exemples

L’exemple suivant écrit un fragment XML dans un flux de mémoire. (Il utilise la Create(Stream, XmlWriterSettings) surcharge, qui configure également les paramètres sur la nouvelle instance d’enregistreur XML.)

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

Remarques

Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut suivants est utilisé pour créer l’enregistreur XML :

Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur créé, utilisez une surcharge qui prend un objet comme l’un XmlWriterSettings de ses arguments et transmettez un XmlWriterSettings objet avec vos paramètres personnalisés.

De plus, XmlWriter écrit toujours une marque d’ordre d’octet (BOM) dans le flux de données sous-jacent ; toutefois, certains flux ne doivent pas avoir de boM. Pour omettre le boM, créez un XmlWriterSettings objet et définissez la propriété Encoding sur un nouvel UTF8Encoding objet avec la valeur booléenne dans le constructeur défini sur false.

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output);

static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter) As XmlWriter

Paramètres

Retours

XmlWriter

Objet XmlWriter autour de l'objet XmlWriter spécifié.

Exceptions

Remarques

Cette méthode vous permet d’ajouter des fonctionnalités à un objet sous-jacent XmlWriter . L’objet sous-jacent XmlWriter peut être un objet créé par la XmlWriter.Create méthode ou un objet créé à l’aide de l’implémentation XmlTextWriter .

Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec des paramètres par défaut est utilisé pour créer l’enregistreur XML.

Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un XmlWriterSettings objet comme l’un de ses arguments et transmettez un XmlWriterSettings objet avec vos paramètres personnalisés.