XmlWriter.Create Метод

Определение

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

Перегрузки

Имя Описание
Create(StringBuilder, XmlWriterSettings)

Создает новый XmlWriter экземпляр с помощью StringBuilder объектов и XmlWriterSettings объектов.

Create(String, XmlWriterSettings)

Создает новый XmlWriter экземпляр с помощью имени файла и XmlWriterSettings объекта.

Create(TextWriter, XmlWriterSettings)

Создает новый XmlWriter экземпляр с помощью TextWriter объектов и XmlWriterSettings объектов.

Create(Stream, XmlWriterSettings)

Создает новый XmlWriter экземпляр с помощью потока и XmlWriterSettings объекта.

Create(XmlWriter, XmlWriterSettings)

Создает новый XmlWriter экземпляр с помощью указанных XmlWriter и XmlWriterSettings объектов.

Create(StringBuilder)

Создает новый XmlWriter экземпляр с помощью указанного StringBuilder.

Create(String)

Создает новый XmlWriter экземпляр с помощью указанного имени файла.

Create(TextWriter)

Создает новый XmlWriter экземпляр с помощью указанного TextWriter.

Create(Stream)

Создает новый XmlWriter экземпляр с помощью указанного потока.

Create(XmlWriter)

Создает новый XmlWriter экземпляр с помощью указанного XmlWriter объекта.

Комментарии

Некоторые Create перегрузки включают settings параметр, принимаюющий XmlWriterSettings объект. Этот объект можно использовать для:

  • Укажите функции, поддерживаемые для созданного XmlWriter объекта.

  • Повторно используйте XmlWriterSettings объект для создания нескольких объектов записи. Объект XmlWriterSettings копируется и помечается только для чтения для каждого созданного модуля записи. Изменения параметров в экземпляре XmlWriterSettings не влияют на существующие записи с теми же параметрами. Таким образом, можно использовать одни и те же параметры для создания нескольких писателей с одной и той же функциональностью. Кроме того, можно изменить параметры экземпляра XmlWriterSettings и создать новый модуль записи с другим набором функций.

  • Добавьте функции в существующий модуль записи XML. Метод Create может принимать другой XmlWriter объект. Базовый XmlWriter объект не должен быть модуль записи XML, созданный статическим Create методом. Например, можно указать определяемый пользователем модуль записи XML, чтобы добавить в нее дополнительные функции.

  • Воспользуйтесь всеми преимуществами таких функций, как проверка соответствия и соответствие рекомендациям XML 1.0 , которые доступны только для XmlWriter объектов, созданных статическим Create методом.

Если вы используете перегрузку CreateXmlWriterSettings , которая не принимает объект, используются следующие параметры записи по умолчанию:

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

Note

Хотя платформа .NET Framework включает класс XmlTextWriter, который представляет собой конкретную реализацию класса XmlWriter, рекомендуется создать экземпляры XmlWriter с помощью метода Create.

Create(StringBuilder, XmlWriterSettings)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью StringBuilder объектов и XmlWriterSettings объектов.

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

Параметры

output
StringBuilder

Значение StringBuilder , в которое нужно написать. Содержимое, написанное приложением XmlWriter , StringBuilderдобавляется в .

settings
XmlWriterSettings

Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.

Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Применяется к

Create(String, XmlWriterSettings)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью имени файла и XmlWriterSettings объекта.

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

Параметры

outputFileName
String

Файл, в который требуется записать. Создает XmlWriter файл по указанному пути и записывает его в текстовый синтаксис XML 1.0. Должен outputFileName быть путь к файловой системе.

settings
XmlWriterSettings

Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.

Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.

Возвращаемое значение

Объект XmlWriter.

Исключения

outputFileName равно null.

Примеры

В следующем примере создается XmlWriter объект с определенными параметрами.

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.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью TextWriter объектов и XmlWriterSettings объектов.

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

Параметры

output
TextWriter

Имя TextWriter , в которое требуется написать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный TextWriter.

settings
XmlWriterSettings

Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.

Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Примеры

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

Применяется к

Create(Stream, XmlWriterSettings)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью потока и XmlWriterSettings объекта.

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

Параметры

output
Stream

Поток, в который требуется записать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный поток.

settings
XmlWriterSettings

Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.

Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Примеры

В следующем примере фрагмент 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.

Комментарии

XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных; однако некоторые потоки не должны иметь BOM. Чтобы опустить BOM, создайте новый XmlWriterSettings объект и задайте для свойства Кодировки новый UTF8Encoding объект с логическим значением в конструкторе, равным false.

Применяется к

Create(XmlWriter, XmlWriterSettings)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью указанных XmlWriter и XmlWriterSettings объектов.

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

Параметры

output
XmlWriter

Объект XmlWriter , который требуется использовать в качестве базового модуля записи.

settings
XmlWriterSettings

Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.

Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.

Возвращаемое значение

Объект XmlWriter , который упакован вокруг указанного XmlWriter объекта.

Исключения

output равно null.

Комментарии

Этот метод позволяет добавлять дополнительные функции в базовый XmlWriter объект. Базовый XmlWriter объект может быть объектом, созданным XmlWriter.Create методом, или объектом, созданным XmlTextWriter с помощью реализации.

Применяется к

Create(StringBuilder)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

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

Параметры

output
StringBuilder

Значение StringBuilder , в которое нужно написать. Содержимое, написанное приложением XmlWriter , StringBuilderдобавляется в .

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Комментарии

При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.

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

Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.

Применяется к

Create(String)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью указанного имени файла.

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

Параметры

outputFileName
String

Файл, в который требуется записать. Создает XmlWriter файл по указанному пути и записывает его в текстовый синтаксис XML 1.0. Должен outputFileName быть путь к файловой системе.

Возвращаемое значение

Объект XmlWriter.

Исключения

outputFileName равно null.

Примеры

В следующем примере создается XmlWriter объект и записывается узел книги.

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

Комментарии

При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.

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

Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.

Применяется к

Create(TextWriter)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

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

Параметры

output
TextWriter

Имя TextWriter , в которое требуется написать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный TextWriter.

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Примеры

В следующем примере создается модуль записи, который выводится в консоль.

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

Комментарии

При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.

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

Если вы хотите указать функции для поддержки созданного модуля записи, используйте перегрузку, которая принимает XmlWriterSettings объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.

Применяется к

Create(Stream)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью указанного потока.

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

Параметры

output
Stream

Поток, в который требуется записать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный поток.

Возвращаемое значение

Объект XmlWriter.

Исключения

output равно null.

Примеры

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

Комментарии

При использовании этой перегрузки XmlWriterSettings объект со следующими параметрами по умолчанию используется для создания модуля записи XML:

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

Если вы хотите указать функции для поддержки созданного модуля записи, используйте перегрузку, которая принимает XmlWriterSettings объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.

Кроме того, XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных; однако некоторые потоки не должны иметь BOM. Чтобы опустить BOM, создайте новый XmlWriterSettings объект и задайте для свойства Кодировки новый UTF8Encoding объект с логическим значением в конструкторе, равным false.

Применяется к

Create(XmlWriter)

Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

Создает новый XmlWriter экземпляр с помощью указанного XmlWriter объекта.

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

Параметры

output
XmlWriter

Объект XmlWriter , который требуется использовать в качестве базового модуля записи.

Возвращаемое значение

Объект XmlWriter , который упакован вокруг указанного XmlWriter объекта.

Исключения

output равно null.

Комментарии

Этот метод позволяет добавлять функции в базовый XmlWriter объект. Базовый XmlWriter объект может быть объектом, созданным XmlWriter.Create методом, или объектом, созданным XmlTextWriter с помощью реализации.

При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.

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

Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.

Применяется к