XmlWriter.Create Metodo

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

Nell'esempio seguente viene creato un XmlWriter oggetto con le impostazioni definite.

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

L'esempio seguente scrive una stringa 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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

Nell'esempio seguente viene scritto un frammento XML in un flusso di memoria.

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.

Commenti

XmlWriter scrive sempre un byte Order Mark (BOM) nel flusso di dati sottostante; tuttavia, alcuni flussi non devono avere una BOM. Per omettere la bom, creare un nuovo XmlWriterSettings oggetto e impostare la proprietà Encoding come nuovo UTF8Encoding oggetto con il valore Boolean nel costruttore impostato su 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

Parametri

Restituisce

Oggetto XmlWriter che ha eseguito il wrapping dell'oggetto XmlWriter specificato.

Eccezioni

Commenti

Questo metodo consente di aggiungere funzionalità aggiuntive a un oggetto sottostante XmlWriter . L'oggetto sottostante XmlWriter può essere un oggetto creato dal XmlWriter.Create metodo o un oggetto creato usando l'implementazione 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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Commenti

Quando si usa questo overload, viene usato un XmlWriterSettings oggetto con impostazioni predefinite per creare il writer XML.

Se si desidera specificare le funzionalità da supportare nel writer XML creato, usare un overload che accetta un XmlWriterSettings oggetto come uno dei relativi argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

Nell'esempio seguente viene creato un oggetto e viene scritto un XmlWriter nodo del libro.

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

Commenti

Quando si usa questo overload, viene usato un XmlWriterSettings oggetto con impostazioni predefinite per creare il writer XML.

Se si desidera specificare le funzionalità da supportare nel writer XML creato, usare un overload che accetta un XmlWriterSettings oggetto come uno dei relativi argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

Nell'esempio seguente viene creato un writer che restituisce l'output della 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

Commenti

Quando si usa questo overload, viene usato un XmlWriterSettings oggetto con impostazioni predefinite per creare il writer XML.

Se si desidera specificare le funzionalità da supportare nel writer creato, usare un overload che accetta un oggetto come uno degli argomenti e passare un XmlWriterSettingsXmlWriterSettings oggetto con le impostazioni personalizzate.

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

Parametri

Restituisce

Oggetto XmlWriter.

Eccezioni

Esempio

Nell'esempio seguente viene scritto un frammento XML in un flusso di memoria. Usa l'overload Create(Stream, XmlWriterSettings) , che configura anche le impostazioni nella nuova istanza del writer 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.

Commenti

Quando si usa questo overload, viene usato un XmlWriterSettings oggetto con le impostazioni predefinite seguenti per creare il writer XML:

Se si desidera specificare le funzionalità da supportare nel writer creato, usare un overload che accetta un oggetto come uno degli argomenti e passare un XmlWriterSettingsXmlWriterSettings oggetto con le impostazioni personalizzate.

XmlWriter scrive sempre un byte Order Mark (BOM) nel flusso di dati sottostante; tuttavia, alcuni flussi non devono avere una BOM. Per omettere la bom, creare un nuovo XmlWriterSettings oggetto e impostare la proprietà Encoding come nuovo UTF8Encoding oggetto con il valore Boolean nel costruttore impostato su 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

Parametri

Restituisce

Oggetto XmlWriter che ha eseguito il wrapping dell'oggetto XmlWriter specificato.

Eccezioni

Commenti

Questo metodo consente di aggiungere funzionalità a un oggetto sottostante XmlWriter . L'oggetto sottostante XmlWriter può essere un oggetto creato dal XmlWriter.Create metodo o un oggetto creato usando l'implementazione XmlTextWriter .

Quando si usa questo overload, viene usato un XmlWriterSettings oggetto con impostazioni predefinite per creare il writer XML.

Se si desidera specificare le funzionalità da supportare nel writer XML creato, usare un overload che accetta un XmlWriterSettings oggetto come uno dei relativi argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.