XmlWriter.Create Method

Definition

Создает новый экземпляр XmlWriter.Creates a new XmlWriter instance.

Overloads

Create(XmlWriter, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием указанных объектов XmlWriter и XmlWriterSettings.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Create(String, XmlWriterSettings)

Создает новый экземпляр XmlWriter с помощью имени файла и объекта XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(TextWriter, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием объектов TextWriter и XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(Stream, XmlWriterSettings)

Создает новый экземпляр XmlWriter с помощью потока и объекта XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(StringBuilder, XmlWriterSettings)

Создает новый экземпляр XmlWriter с использованием объектов StringBuilder и XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(StringBuilder)

Создает новый экземпляр XmlWriter с использованием указанного StringBuilder.Creates a new XmlWriter instance using the specified StringBuilder.

Create(String)

Создает новый экземпляр XmlWriter с использованием указанного имени файла.Creates a new XmlWriter instance using the specified filename.

Create(TextWriter)

Создает новый экземпляр XmlWriter с использованием указанного TextWriter.Creates a new XmlWriter instance using the specified TextWriter.

Create(Stream)

Создает новый экземпляр XmlWriter с использованием указанного потока.Creates a new XmlWriter instance using the specified stream.

Create(XmlWriter)

Создает новый экземпляр XmlWriter с использованием указанного объекта XmlWriter.Creates a new XmlWriter instance using the specified XmlWriter object.

Remarks

Некоторые перегрузки Create включают параметр settings, принимающий объект XmlWriterSettings.Some of the Create overloads include a settings parameter that accepts an XmlWriterSettings object. Этот объект можно использовать для следующих действий:You can use this object to:

  • Укажите, какие функции должны поддерживаться для созданного объекта XmlWriter.Specify which features you want supported on the created XmlWriter object.

  • Повторно используйте объект XmlWriterSettings для создания нескольких объектов модуля записи.Reuse the XmlWriterSettings object to create multiple writer objects. Объект XmlWriterSettings копируется и помечается признаком «только для чтения» для каждого созданного модуля записи.The XmlWriterSettings object is copied and marked read-only for each created writer. Изменения в настройках экземпляра XmlWriterSettings не влияют на существующие модули записи с такими же настройками.Changes to the settings on an XmlWriterSettings instance do not affect existing writers with the same settings. Таким образом, можно создать несколько модулей записи с одинаковой функциональностью, используя одинаковые настройки.Thus, you can use the same settings to create multiple writers with the same functionality. Или можно изменить экземпляр XmlWriterSettings и создать новый модуль записи с другим набором функций.Or, you can modify the settings on an XmlWriterSettings instance and create a new writer with a different set of features.

  • Добавление компонентов в существующий модуль записи XML.Add features to an existing XML writer. Метод Create может принимать другой объект XmlWriter.The Create method can accept another XmlWriter object. Базовый объект XmlWriter не обязательно должен быть модулем записи XML, созданным статическим методом Create.The underlying XmlWriter object does not have to be an XML writer created by the static Create method. Например, можно указать определяемый пользователем модуль записи XML для добавления дополнительных компонентов.For example, you can specify a user-defined XML writer to add additional features to.

  • Воспользуйтесь всеми преимуществами таких функций, как улучшенная проверка соответствия и соответствие рекомендациям XML 1,0 , которые доступны только для XmlWriter объектов, созданных статическим методом Create.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.

При использовании перегрузки Create, которая не принимает объект XmlWriterSettings, используются следующие параметры модуля записи по умолчанию:If you use a Create overload that doesn't accept an XmlWriterSettings object, the following default writer settings are used:

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Note

Хотя .NET Framework включает класс XmlTextWriter, который является конкретной реализацией XmlWriter класса, рекомендуется создавать XmlWriter экземпляры с помощью метода Create.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)

Создает новый экземпляр XmlWriter с использованием указанных объектов XmlWriter и XmlWriterSettings.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

Parameters

output
XmlWriter

Объект XmlWriter, который следует использовать в качестве базового средства записи.The XmlWriter object that you want to use as the underlying writer.

settings
XmlWriterSettings

Объект XmlWriterSettings, использованный для настройки нового экземпляраXmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Если значение равно null, используется XmlWriterSettings с параметрами по умолчанию.If this is null, a XmlWriterSettings with default settings is used.

Если XmlWriter используется вместе с методом Transform(String, XmlWriter), необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами.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. Это гарантирует правильность параметров выходных данных для объекта XmlWriter.This ensures that the created XmlWriter object has the correct output settings.

Returns

XmlWriter

Возвращает объект XmlWriter, являющийся оболочкой указанного объекта XmlWriter.An XmlWriter object that is wrapped around the specified XmlWriter object.

Exceptions

Значение writer равно null.The writer value is null.

Remarks

Этот метод позволяет добавлять дополнительные функции к базовому объекту XmlWriter.This method allows you add additional features to an underlying XmlWriter object. Базовым объектом XmlWriter может быть объект, созданный методом XmlWriter.Create, или объект, созданный с помощью реализации XmlTextWriter.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)

Создает новый экземпляр XmlWriter с помощью имени файла и объекта 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

Parameters

outputFileName
String

Файл, в который будет выполняться запись.The file to which you want to write. Метод XmlWriter создает файл по указанному пути и записывает в него, используя синтаксис текста XML 1.0.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Параметр outputFileName должен являться путем файловой системы.The outputFileName must be a file system path.

settings
XmlWriterSettings

Объект XmlWriterSettings, использованный для настройки нового экземпляраXmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Если значение равно null, используется XmlWriterSettings с параметрами по умолчанию.If this is null, a XmlWriterSettings with default settings is used.

Если XmlWriter используется вместе с методом Transform(String, XmlWriter), необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами.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. Это гарантирует правильность параметров выходных данных для объекта XmlWriter.This ensures that the created XmlWriter object has the correct output settings.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение url равно null.The url value is null.

Examples

В следующем примере создается объект XmlWriter с определенными параметрами.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)

Создает новый экземпляр XmlWriter с использованием объектов TextWriter и 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

Parameters

output
TextWriter

TextWriter, в которое необходимо записать.The TextWriter to which you want to write. Объект XmlWriter записывает синтаксис текста XML 1.0 и добавляет его к указанному потоку TextWriter.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

settings
XmlWriterSettings

Объект XmlWriterSettings, использованный для настройки нового экземпляраXmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Если значение равно null, используется XmlWriterSettings с параметрами по умолчанию.If this is null, a XmlWriterSettings with default settings is used.

Если XmlWriter используется вместе с методом Transform(String, XmlWriter), необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами.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. Это гарантирует правильность параметров выходных данных для объекта XmlWriter.This ensures that the created XmlWriter object has the correct output settings.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение text равно null.The text value is null.

Examples

В следующем примере записывается 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)

Создает новый экземпляр XmlWriter с помощью потока и объекта 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

Parameters

output
Stream

Поток, в который будет выполняться запись.The stream to which you want to write. XmlWriter записывает синтаксис текста XML 1.0 и добавляет его к указанному потоку.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

settings
XmlWriterSettings

Объект XmlWriterSettings, использованный для настройки нового экземпляраXmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Если значение равно null, используется XmlWriterSettings с параметрами по умолчанию.If this is null, a XmlWriterSettings with default settings is used.

Если XmlWriter используется вместе с методом Transform(String, XmlWriter), необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами.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. Это гарантирует правильность параметров выходных данных для объекта XmlWriter.This ensures that the created XmlWriter object has the correct output settings.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение stream равно null.The stream value is null.

Examples

В следующем примере фрагмент XML записывается в поток памяти.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 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.

Remarks

XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных; Однако некоторые потоки не должны иметь BOM.XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Чтобы опустить СПЕЦИФИКАЦИю, создайте новый объект XmlWriterSettings и задайте свойство Encoding в качестве нового объекта UTF8Encoding с логическим значением в конструкторе, имеющим значение 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)

Создает новый экземпляр XmlWriter с использованием объектов StringBuilder и 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

Parameters

output
StringBuilder

Класс StringBuilder, в который осуществляется запись.The StringBuilder to which to write to. Содержимое, записанное методом XmlWriter, добавляется в StringBuilder.Content written by the XmlWriter is appended to the StringBuilder.

settings
XmlWriterSettings

Объект XmlWriterSettings, использованный для настройки нового экземпляраXmlWriter.The XmlWriterSettings object used to configure the new XmlWriter instance. Если значение равно null, используется XmlWriterSettings с параметрами по умолчанию.If this is null, a XmlWriterSettings with default settings is used.

Если XmlWriter используется вместе с методом Transform(String, XmlWriter), необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами.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. Это гарантирует правильность параметров выходных данных для объекта XmlWriter.This ensures that the created XmlWriter object has the correct output settings.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение builder равно null.The builder value is null.

Create(StringBuilder)

Создает новый экземпляр XmlWriter с использованием указанного StringBuilder.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

Parameters

output
StringBuilder

Класс StringBuilder, в который осуществляется запись.The StringBuilder to which to write to. Содержимое, записанное методом XmlWriter, добавляется в StringBuilder.Content written by the XmlWriter is appended to the StringBuilder.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение builder равно null.The builder value is null.

Remarks

При использовании этой перегрузки для создания модуля записи XML используется объект XmlWriterSettings с параметрами по умолчанию.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Если необходимо указать функции для поддержки в созданном модуле записи XML, используйте перегрузку, которая принимает объект XmlWriterSettings как один из своих аргументов, и передает объект XmlWriterSettings с пользовательскими параметрами.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)

Создает новый экземпляр XmlWriter с использованием указанного имени файла.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

Parameters

outputFileName
String

Файл, в который будет выполняться запись.The file to which you want to write. Метод XmlWriter создает файл по указанному пути и записывает в него, используя синтаксис текста XML 1.0.The XmlWriter creates a file at the specified path and writes to it in XML 1.0 text syntax. Параметр outputFileName должен являться путем файловой системы.The outputFileName must be a file system path.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение url равно null.The url value is null.

Examples

В следующем примере создается объект XmlWriter и записывается узел книги.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

Remarks

При использовании этой перегрузки для создания модуля записи XML используется объект XmlWriterSettings с параметрами по умолчанию.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Если необходимо указать функции для поддержки в созданном модуле записи XML, используйте перегрузку, которая принимает объект XmlWriterSettings как один из своих аргументов, и передает объект XmlWriterSettings с пользовательскими параметрами.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)

Создает новый экземпляр XmlWriter с использованием указанного TextWriter.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

Parameters

output
TextWriter

TextWriter, в которое необходимо записать.The TextWriter to which you want to write. Объект XmlWriter записывает синтаксис текста XML 1.0 и добавляет его к указанному потоку TextWriter.The XmlWriter writes XML 1.0 text syntax and appends it to the specified TextWriter.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение text равно null.The text value is null.

Examples

В следующем примере создается модуль записи, выводящий данные в консоль.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

Remarks

При использовании этой перегрузки для создания модуля записи XML используется объект XmlWriterSettings с параметрами по умолчанию.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Если необходимо указать функции для поддержки в созданном модуле записи, используйте перегрузку, которая принимает объект XmlWriterSettings как один из своих аргументов, и передает объект XmlWriterSettings с пользовательскими параметрами.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)

Создает новый экземпляр XmlWriter с использованием указанного потока.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

Parameters

output
Stream

Поток, в который будет выполняться запись.The stream to which you want to write. XmlWriter записывает синтаксис текста XML 1.0 и добавляет его к указанному потоку.The XmlWriter writes XML 1.0 text syntax and appends it to the specified stream.

Returns

XmlWriter

Объект XmlWriter.An XmlWriter object.

Exceptions

Значение stream равно null.The stream value is null.

Examples

В следующем примере фрагмент XML записывается в поток памяти.The following example writes an XML fragment to a memory stream. (Он использует перегрузку Create(Stream, XmlWriterSettings), которая также настраивает параметры для нового экземпляра модуля записи 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 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.

Remarks

При использовании этой перегрузки для создания модуля записи XML используется объект XmlWriterSettings со следующими параметрами по умолчанию:When you use this overload, an XmlWriterSettings object with the following default settings is used to create the XML writer:

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Если необходимо указать функции для поддержки в созданном модуле записи, используйте перегрузку, которая принимает объект XmlWriterSettings как один из своих аргументов, и передает объект XmlWriterSettings с пользовательскими параметрами.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.

Кроме того, XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных. Однако некоторые потоки не должны иметь BOM.Also, XmlWriter always writes a Byte Order Mark (BOM) to the underlying data stream; however, some streams must not have a BOM. Чтобы опустить СПЕЦИФИКАЦИю, создайте новый объект XmlWriterSettings и задайте свойство Encoding в качестве нового объекта UTF8Encoding с логическим значением в конструкторе, имеющим значение 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)

Создает новый экземпляр XmlWriter с использованием указанного объекта XmlWriter.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

Parameters

output
XmlWriter

Объект XmlWriter, который следует использовать в качестве базового средства записи.The XmlWriter object that you want to use as the underlying writer.

Returns

XmlWriter

Возвращает объект XmlWriter, являющийся оболочкой указанного объекта XmlWriter.An XmlWriter object that is wrapped around the specified XmlWriter object.

Exceptions

Значение writer равно null.The writer value is null.

Remarks

Этот метод позволяет добавлять компоненты в базовый объект XmlWriter.This method allows you add features to an underlying XmlWriter object. Базовым объектом XmlWriter может быть объект, созданный методом XmlWriter.Create, или объект, созданный с помощью реализации XmlTextWriter.The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

При использовании этой перегрузки для создания модуля записи XML используется объект XmlWriterSettings с параметрами по умолчанию.When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

ПараметрSetting По умолчаниюDefault
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Два пробелаTwo spaces
NamespaceHandling Default (без удаления)Default (no removal)
NewLineChars \r\n (возврат каретки, новая строка)\r\n (carriage return, new line)
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Если необходимо указать функции для поддержки в созданном модуле записи XML, используйте перегрузку, которая принимает объект XmlWriterSettings как один из своих аргументов, и передает объект XmlWriterSettings с пользовательскими параметрами.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.

Applies to