XmlWriter.Create XmlWriter.Create XmlWriter.Create XmlWriter.Create Method

Definizione

Crea una nuova istanza di XmlWriter.Creates a new XmlWriter instance.

Overload

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti XmlWriter e XmlWriterSettings specificati.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando il nome file e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti TextWriter e XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Crea una nuova istanza della classe XmlWriter utilizzando il flusso e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti StringBuilder e XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto StringBuilder specificato.Creates a new XmlWriter instance using the specified StringBuilder.

Create(String) Create(String) Create(String) Create(String)

Crea una nuova istanza della classe XmlWriter utilizzando il nome file specificato.Creates a new XmlWriter instance using the specified filename.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto TextWriter specificato.Creates a new XmlWriter instance using the specified TextWriter.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Crea una nuova istanza di XmlWriter utilizzando il flusso specificato.Creates a new XmlWriter instance using the specified stream.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Crea una nuova istanza della classe XmlWriter utilizzando l'oggetto XmlWriter specificato.Creates a new XmlWriter instance using the specified XmlWriter object.

Commenti

Alcuni degli Create Overload includono un settings parametro che accetta un XmlWriterSettings oggetto.Some of the Create overloads include a settings parameter that accepts an XmlWriterSettings object. È possibile utilizzare questo oggetto per:You can use this object to:

  • Specificare le funzionalità che si desidera supportare nell'oggetto XmlWriter creato.Specify which features you want supported on the created XmlWriter object.

  • Riutilizzare XmlWriterSettings l'oggetto per creare più oggetti writer.Reuse the XmlWriterSettings object to create multiple writer objects. L'oggetto XmlWriterSettings viene copiato e contrassegnato in sola lettura per ogni writer creato.The XmlWriterSettings object is copied and marked read-only for each created writer. Le modifiche alle impostazioni in un'istanza di XmlWriterSettings non influenzano i writer esistenti con le stesse impostazioni.Changes to the settings on an XmlWriterSettings instance do not affect existing writers with the same settings. In tal modo è possibile utilizzare le stesse impostazioni per creare più writer con la stessa funzionalità.Thus, you can use the same settings to create multiple writers with the same functionality. Oppure è possibile modificare le impostazioni in un'istanza di XmlWriterSettings e creare un nuovo writer con un set di funzionalità diverso.Or, you can modify the settings on an XmlWriterSettings instance and create a new writer with a different set of features.

  • Aggiungere funzionalità a un writer XML esistente.Add features to an existing XML writer. Il metodo Create può accettare un altro oggetto XmlWriter.The Create method can accept another XmlWriter object. Non è XmlWriter necessario che l'oggetto sottostante sia un writer XML creato dal metodo statico Create .The underlying XmlWriter object does not have to be an XML writer created by the static Create method. È ad esempio possibile specificare un writer XML definito dall'utente al quale aggiungere funzionalità aggiuntive.For example, you can specify a user-defined XML writer to add additional features to.

  • Sfruttare appieno le funzionalità, ad esempio il controllo della conformità migliore e la conformità alla raccomandazione XML 1,0 , disponibile solo per XmlWriter gli oggetti creati dal metodo Create statico.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 recommendation that are available only on XmlWriter objects created by the static Create method.

Se si usa un Create overload che non accetta un XmlWriterSettings oggetto, vengono usate le impostazioni predefinite del writer seguenti:If you use a Create overload that doesn't accept an XmlWriterSettings object, the following default writer settings are used:

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Nota

Sebbene il .NET Framework includa XmlTextWriter la classe, che è un'implementazione concreta XmlWriter della classe, è consigliabile creare XmlWriter istanze di tramite il Create metodo.Although the .NET Framework includes the XmlTextWriter class, which is a concrete implementation of the XmlWriter class, we recommend that you create XmlWriter instances by using the Create method.

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti XmlWriter e XmlWriterSettings specificati.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

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

output
XmlWriter XmlWriter XmlWriter XmlWriter

Oggetto XmlWriter da utilizzare come writer sottostante.The XmlWriter object that you want to use as the underlying writer.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Oggetto XmlWriterSettings utilizzato per configurare la nuova istanza della classe XmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Se è null, viene utilizzato un oggetto XmlWriterSettings con le impostazioni predefinite.If this is null, a XmlWriterSettings with default settings is used.

Se si utilizza la classe XmlWriter con il metodo Transform(String, XmlWriter), è necessario utilizzare la proprietà OutputSettings per ottenere un oggetto XmlWriterSettings con le impostazioni corrette.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter creato siano corrette.This ensures that the created XmlWriter object has the correct output settings.

Restituisce

Oggetto XmlWriter che ha eseguito il wrapping dell'oggetto XmlWriter specificato.An XmlWriter object that is wrapped around the specified XmlWriter object.

Eccezioni

Il valore di writer è null.The writer value is null.

Commenti

Questo metodo consente di aggiungere ulteriori funzionalità a un oggetto XmlWriter sottostante.This method allows you add additional features to an underlying XmlWriter object. L'oggetto XmlWriter sottostante può essere un oggetto creato XmlWriter.Create dal metodo o un oggetto creato mediante l' XmlTextWriter implementazione di.The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando il nome file e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

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);
static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter

Parametri

outputFileName
String String String String

File in cui scrivere.The file to which you want to write. La classe XmlWriter crea un file nella posizione specificata e lo scrive nella sintassi di testo di XML 1.0.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Il outputFileName deve essere un percorso del file system.The outputFileName must be a file system path.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Oggetto XmlWriterSettings utilizzato per configurare la nuova istanza della classe XmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Se è null, viene utilizzato un oggetto XmlWriterSettings con le impostazioni predefinite.If this is null, a XmlWriterSettings with default settings is used.

Se si utilizza la classe XmlWriter con il metodo Transform(String, XmlWriter), è necessario utilizzare la proprietà OutputSettings per ottenere un oggetto XmlWriterSettings con le impostazioni corrette.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter creato siano corrette.This ensures that the created XmlWriter object has the correct output settings.

Restituisce

Eccezioni

Esempi

Nell'esempio seguente viene creato XmlWriter un oggetto con le impostazioni definite.The following example creates an XmlWriter object with the defined settings.

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 

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti TextWriter e XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

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

output
TextWriter TextWriter TextWriter TextWriter

TextWriter in cui si desidera scrivere.The TextWriter to which you want to write. La classe XmlWriter scrive la sintassi del testo di XML 1.0 e la aggiunge alla classe TextWriter specificata.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Oggetto XmlWriterSettings utilizzato per configurare la nuova istanza della classe XmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Se è null, viene utilizzato un oggetto XmlWriterSettings con le impostazioni predefinite.If this is null, a XmlWriterSettings with default settings is used.

Se si utilizza la classe XmlWriter con il metodo Transform(String, XmlWriter), è necessario utilizzare la proprietà OutputSettings per ottenere un oggetto XmlWriterSettings con le impostazioni corrette.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter creato siano corrette.This ensures that the created XmlWriter object has the correct output settings.

Restituisce

Eccezioni

Esempi

Nell'esempio seguente viene scritta una stringa XML.The following example writes out an XML string.

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

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Crea una nuova istanza della classe XmlWriter utilizzando il flusso e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

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

output
Stream Stream Stream Stream

Flusso in cui scrivere.The stream to which you want to write. Il XmlWriter scrive la sintassi del testo di XML 1.0 e la aggiunge al flusso specificato.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Oggetto XmlWriterSettings utilizzato per configurare la nuova istanza della classe XmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Se è null, viene utilizzato un oggetto XmlWriterSettings con le impostazioni predefinite.If this is null, a XmlWriterSettings with default settings is used.

Se si utilizza la classe XmlWriter con il metodo Transform(String, XmlWriter), è necessario utilizzare la proprietà OutputSettings per ottenere un oggetto XmlWriterSettings con le impostazioni corrette.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter creato siano corrette.This ensures that the created XmlWriter object has the correct output settings.

Restituisce

Eccezioni

Il valore di stream è null.The stream value is null.

Esempi

Nell'esempio seguente viene scritto un frammento XML in un flusso di memoria.The following example writes an XML fragment to a memory stream.

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 additonal 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 additonal processing on the stream.

Commenti

XmlWriter scrive sempre un indicatore per l'ordine dei byte (BOM) nel flusso di dati sottostante; Tuttavia, alcuni flussi non devono avere un BOM.XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Per omettere l'indicatore BOM, creare XmlWriterSettings un nuovo oggetto e impostare la proprietà Encoding su un UTF8Encoding nuovo oggetto con il valore booleano nel costruttore impostato su false.To omit the BOM, create a new XmlWriterSettings object and set the Encoding property to be a new UTF8Encoding object with the Boolean value in the constructor set to false.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti StringBuilder e XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

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

output
StringBuilder StringBuilder StringBuilder StringBuilder

StringBuilder in cui scrivere.The StringBuilder to which to write to. Il contenuto scritto dalla classe XmlWriter viene aggiunto alla classe StringBuilder.Content written by the XmlWriter is appended to the StringBuilder.

settings
XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings

Oggetto XmlWriterSettings utilizzato per configurare la nuova istanza della classe XmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Se è null, viene utilizzato un oggetto XmlWriterSettings con le impostazioni predefinite.If this is null, a XmlWriterSettings with default settings is used.

Se si utilizza la classe XmlWriter con il metodo Transform(String, XmlWriter), è necessario utilizzare la proprietà OutputSettings per ottenere un oggetto XmlWriterSettings con le impostazioni corrette.If the XmlWriter is being used with the Transform(String, XmlWriter) method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter creato siano corrette.This ensures that the created XmlWriter object has the correct output settings.

Restituisce

Eccezioni

Il valore di builder è null.The builder value is null.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto StringBuilder specificato.Creates a new XmlWriter instance using the specified StringBuilder.

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

output
StringBuilder StringBuilder StringBuilder StringBuilder

StringBuilder in cui scrivere.The StringBuilder to which to write to. Il contenuto scritto dalla classe XmlWriter viene aggiunto alla classe StringBuilder.Content written by the XmlWriter is appended to the StringBuilder.

Restituisce

Eccezioni

Il valore di builder è null.The builder value is null.

Commenti

Quando si utilizza questo overload, per XmlWriterSettings creare il writer XML viene utilizzato un oggetto con le impostazioni predefinite.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Se si desidera specificare le funzionalità da supportare nel writer XML creato, utilizzare un overload che accetta un XmlWriterSettings oggetto come uno degli argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Create(String) Create(String) Create(String) Create(String)

Crea una nuova istanza della classe XmlWriter utilizzando il nome file specificato.Creates a new XmlWriter instance using the specified filename.

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

outputFileName
String String String String

File in cui scrivere.The file to which you want to write. La classe XmlWriter crea un file nella posizione specificata e lo scrive nella sintassi di testo di XML 1.0.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Il outputFileName deve essere un percorso del file system.The outputFileName must be a file system path.

Restituisce

Eccezioni

Esempi

Nell'esempio seguente viene creato XmlWriter un oggetto e viene scritto un nodo libro.The following example creates an XmlWriter object and writes a book node.

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 utilizza questo overload, per XmlWriterSettings creare il writer XML viene utilizzato un oggetto con le impostazioni predefinite.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Se si desidera specificare le funzionalità da supportare nel writer XML creato, utilizzare un overload che accetta un XmlWriterSettings oggetto come uno degli argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto TextWriter specificato.Creates a new XmlWriter instance using the specified TextWriter.

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

output
TextWriter TextWriter TextWriter TextWriter

TextWriter in cui si desidera scrivere.The TextWriter to which you want to write. La classe XmlWriter scrive la sintassi del testo di XML 1.0 e la aggiunge alla classe TextWriter specificata.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

Restituisce

Eccezioni

Esempi

Nell'esempio seguente viene creato un writer che restituisce alla console.The following example creates a writer that outputs to the 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 utilizza questo overload, per XmlWriterSettings creare il writer XML viene utilizzato un oggetto con le impostazioni predefinite.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Se si desidera specificare le funzionalità da supportare nel writer creato, utilizzare un overload che accetta un XmlWriterSettings oggetto come uno degli argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.If you want to specify the features to support on the created writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in an XmlWriterSettings object with your custom settings.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Crea una nuova istanza di XmlWriter utilizzando il flusso specificato.Creates a new XmlWriter instance using the specified stream.

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

output
Stream Stream Stream Stream

Flusso in cui scrivere.The stream to which you want to write. Il XmlWriter scrive la sintassi del testo di XML 1.0 e la aggiunge al flusso specificato.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

Restituisce

Eccezioni

Il valore di stream è null.The stream value is null.

Esempi

Nell'esempio seguente viene scritto un frammento XML in un flusso di memoria.The following example writes an XML fragment to a memory stream. Usa l' Create(Stream, XmlWriterSettings) overload di, che configura anche le impostazioni nella nuova istanza del writer XML.(It uses the Create(Stream, XmlWriterSettings) overload, which also configures the settings on the new XML writer instance.)

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 additonal 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 additonal processing on the stream.

Commenti

Quando si utilizza questo overload, per XmlWriterSettings creare il writer XML viene utilizzato un oggetto con le impostazioni predefinite seguenti:When you use this overload, an XmlWriterSettings object with the following default settings is used to create the XML writer:

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Se si desidera specificare le funzionalità da supportare nel writer creato, utilizzare un overload che accetta un XmlWriterSettings oggetto come uno degli argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.If you want to specify the features to support on the created writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in an XmlWriterSettings object with your custom settings.

Inoltre, XmlWriter scrive sempre un byte order mark (BOM) nel flusso di dati sottostante; Tuttavia, alcuni flussi non devono avere un BOM.Also, XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Per omettere l'indicatore BOM, creare XmlWriterSettings un nuovo oggetto e impostare la proprietà Encoding su un UTF8Encoding nuovo oggetto con il valore booleano nel costruttore impostato su false.To omit the BOM, create a new XmlWriterSettings object and set the Encoding property to be a new UTF8Encoding object with the Boolean value in the constructor set to false.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Crea una nuova istanza della classe XmlWriter utilizzando l'oggetto XmlWriter specificato.Creates a new XmlWriter instance using the specified XmlWriter object.

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

output
XmlWriter XmlWriter XmlWriter XmlWriter

Oggetto XmlWriter da utilizzare come writer sottostante.The XmlWriter object that you want to use as the underlying writer.

Restituisce

Oggetto XmlWriter che ha eseguito il wrapping dell'oggetto XmlWriter specificato.An XmlWriter object that is wrapped around the specified XmlWriter object.

Eccezioni

Il valore di writer è null.The writer value is null.

Commenti

Questo metodo consente di aggiungere funzionalità a un oggetto XmlWriter sottostante.This method allows you add features to an underlying XmlWriter object. L'oggetto XmlWriter sottostante può essere un oggetto creato XmlWriter.Create dal metodo o un oggetto creato mediante l' XmlTextWriter implementazione di.The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

Quando si utilizza questo overload, per XmlWriterSettings creare il writer XML viene utilizzato un oggetto con le impostazioni predefinite.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ImpostazioneSetting Impostazione predefinitaDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Due spaziTwo spaces
NamespaceHandling Default(nessuna rimozione)Default (no removal)
NewLineChars \r\n(ritorno a capo, nuova riga)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Se si desidera specificare le funzionalità da supportare nel writer XML creato, utilizzare un overload che accetta un XmlWriterSettings oggetto come uno degli argomenti e passare un XmlWriterSettings oggetto con le impostazioni personalizzate.If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Si applica a